Provedores de Gateway
O sistema suporta três provedores de pagamento, cada um com capacidades específicas.
Provedores Disponíveis
Pagar.me (PAGARME)
- Propósito: Processamento de cartões de crédito
- Métodos suportados: Cartão de crédito apenas
- API: Pagar.me v5 (https://api.pagar.me/core/v5)
- Ambiente: Sandbox e Produção
Credenciais necessárias:
| Campo | Obrigatório | Descrição |
|---|---|---|
secretKey | Sim | Chave secreta da API |
publicKey | Não | Chave pública para tokenização |
merchantId | Não | ID do merchant |
accountId | Não | ID da conta |
Funcionalidades:
- Tokenização de cartões (cliente → token → gateway)
- Autorização e captura
- Reembolsos totais e parciais
- Gerenciamento de clientes e cartões no gateway
Kobana (KOBANA)
- Propósito: Métodos de pagamento brasileiros
- Métodos suportados: Boleto bancário e PIX
- Ambiente: Sandbox e Produção
Credenciais necessárias:
| Campo | Obrigatório | Descrição |
|---|---|---|
accessToken | Sim | Token de acesso à API |
billetAccountId | Não | ID da conta de boletos |
pixAccountUid | Não | UID da conta PIX (obrigatório para PIX) |
webhookSecret | Não | Segredo para validação de webhooks |
Funcionalidades:
- Emissão de boletos com código de barras e PDF
- Geração de QR Code PIX (EMV)
- Cancelamento de cobranças
- Webhooks para confirmação de pagamento
Mock (MOCK)
- Propósito: Desenvolvimento e testes
- Métodos suportados: Cartão, Boleto e PIX
- Credenciais: Nenhuma necessária
- Ativação: Automática ao criar
Simula todos os tipos de pagamento para ambiente de desenvolvimento.
Métodos de Pagamento por Provedor
| Método | Pagar.me | Kobana | Mock |
|---|---|---|---|
| Cartão de crédito | Sim | - | Sim |
| Boleto bancário | - | Sim | Sim |
| PIX | - | Sim | Sim |
| Transferência | - | - | - |
Segurança de Credenciais
- Todas as credenciais são criptografadas em repouso usando AES-256-GCM
- Credenciais são descriptografadas apenas no momento da chamada à API
- Respostas da API mascaram credenciais (formato:
****[últimos 4]) - Campos sensíveis são filtrados dos logs