Fundamentos — Arquitetura da plataforma
Fundamentos
Arquitetura da plataforma
A Diamond Pay é uma camada única entre a sua empresa e os provedores de pagamento. Você se autentica uma vez, fala conosco, e nós processamos pelo adquirente, roteamos e acompanhamos a liquidação na sua conta.
A plataforma opera em três contextos que você controla diretamente: a API de carteiras (receber e cobrar), a API de pagamentos (saques e transferências), e o portal do lojista (operação e relatórios). Tudo o que a sua empresa precisa está acessível por essas três superfícies.
Receber
Cobranças Pix, cartão, boleto e carteiras digitais por tipo de transação.
Pagar
Saque para a sua conta bancária (Pix ou TED) e transferências internas de split.
Cartão
Tokenização, Zeroauth, BIN lookup e 3DS para proteger cada transação.
Gerir
Portal do lojista com credenciais, transações, estornos e analytics.
Como um pagamento flui
- Autenticação: sua aplicação obtém um token JWT usando client_id e client_secret.
- Criação da cobrança: você envia o payload da cobrança para /bank/wallet/charge/.
- Processamento: a plataforma roteia para o provedor correto, aplica as regras de risco e decide aprovação, revisão ou rejeição.
- Resposta síncrona: você recebe o status, o payload de pagamento (QR Code Pix, URL de boleto, ID de transação).
- Confirmação: quando o pagamento é confirmado, um webhook notifica sua aplicação em tempo real.
- Liquidação: o adquirente credita sua parte na sua conta, no prazo de cada meio.