Pagamentos via API
Conecte depósitos, saques e alterações de status entre sua plataforma e os serviços de pagamento escolhidos.
Como funciona na prática
Um pagamento confiável não termina quando a solicitação recebe sucesso. Os sistemas precisam concordar sobre a identidade da transação, a autorização, seu estado final e a conciliação.
Principais requisitos técnicos
- Solicitações de depósito e saque, escolha do método e redirecionamentos.
- Notificações assinadas, validação e proteção contra eventos repetidos.
- Estados de transações pendentes, recusadas, revertidas ou concluídas.
- Histórico, arquivos de conciliação e rastreabilidade para o suporte.
Métodos disponíveis, estornos, moedas e exigências de conformidade dependem do processador, do operador e do mercado.
Como esta conexão é planejada
Estas etapas apresentam os pontos técnicos a resolver. A implementação e as entregas finais dependem dos sistemas envolvidos e do escopo acordado.
Definir quem controla a transação
Alinhamos onde o depósito ou saque começa, qual sistema aprova a operação e como a referência externa se relaciona ao livro de movimentos da carteira.
Normalizar os estados
Tratamos pendência, autorização, conclusão, recusa, reversão e contestação como eventos distintos quando o método de pagamento oferece esses estados.
Criar caminho de conciliação
Definimos o relatório ou endpoint para comparar a liquidação do processador, os lançamentos na carteira e o histórico visível ao usuário.
O que precisamos analisar
- Métodos de pagamento, moedas e países de atuação
- Carteira existente, serviços financeiros e relatórios
- Documentação do processador para callbacks, estornos e saques
Cenários de aceite a planejar
- Uma notificação validada não credita a carteira duas vezes.
- Um saque pendente não aparece como liquidado antes da confirmação exigida.
- Um pagamento revertido permanece vinculado à transação original.
O que definir antes da implementação
É possível integrar mais de um provedor de pagamentos?
Uma arquitetura com vários fornecedores é viável quando roteamento, estados de transação e responsabilidade pela liquidação são consistentes.
Como evitar depósitos duplicados?
Relacionando IDs externos e internos e validando callbacks repetidos ou atrasados conforme o estado atual da transação.
A API inclui abertura de conta de comerciante?
Não. A descrição da API não implica credenciamento nem aprovação para processar pagamentos. Essas condições são negociadas separadamente com o fornecedor.
Como as assinaturas de pagamento são verificadas?
A implementação segue o protocolo do gateway, incluindo os campos assinados, rotação de segredos e proteção contra reenvio quando disponível.