Papel da plataforma
A clearpago atua como camada entre o seu sistema e o parceiro bancário (BaaS). Você consome somente a API REST e as notificações HTTP assinadas; diferenças de instituição, transporte e mapeamento de eventos permanecem encapsuladas. Este portal é a documentação ClearPago dessa integração: contrato técnico, fluxos e boas práticas para o time de integração.Modelo assíncrono (padrão)
- Criação rápida:
POSTde cash-in, cash-out e refund costuma retornar com estado ainda em evolução (PENDING, reserva, etc.). - Conclusão fora do request/response primário: a liquidação e falhas finais chegam via webhook do parceiro processado internamente e/ou reconciliação quando a rede ou o parceiro responde de forma ambígua (timeout, 5xx, atraso).
- Não trate o corpo de resposta de criação como estado terminal salvo o que o documento de status explicitar para o seu caso.