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

  1. Autenticação: sua aplicação obtém um token JWT usando client_id e client_secret.
  2. Criação da cobrança: você envia o payload da cobrança para /bank/wallet/charge/.
  3. Processamento: a plataforma roteia para o provedor correto, aplica as regras de risco e decide aprovação, revisão ou rejeição.
  4. Resposta síncrona: você recebe o status, o payload de pagamento (QR Code Pix, URL de boleto, ID de transação).
  5. Confirmação: quando o pagamento é confirmado, um webhook notifica sua aplicação em tempo real.
  6. Liquidação: o adquirente credita sua parte na sua conta, no prazo de cada meio.