Fundamentals — Platform architecture

Fundamentals

Platform architecture

Double Diamond Pay is a single layer between your company and the payment providers. You authenticate once, talk to us, and we handle processing, routing and settlement.

The platform runs in three contexts you control directly: the wallet API (collect and charge), the payment API (pay out balance), and the merchant portal (operations and reports). Everything your company needs is reachable through these three surfaces.

Collect

Pix, card, boleto, e-wallet, SPEI, OXXO and more charges by transaction type.

Pay out

Payouts to any destination (Pix, TED, SPEI, cash pick-up and internal).

Cards

Tokenization, Zeroauth, BIN lookup and 3DS to protect every transaction.

Manage

Merchant portal with credentials, transactions, refunds and analytics.

How a payment flows

  1. Authentication: your application obtains a JWT using client_id and client_secret.
  2. Charge creation: you send the charge payload to /bank/wallet/charge/.
  3. Processing: the platform routes to the right provider, applies risk rules and decides approval, review or rejection.
  4. Synchronous response: you get the status and the payment payload (Pix QR Code, boleto URL, transaction ID).
  5. Confirmation: when payment is confirmed, a webhook notifies your application in real time.
  6. Settlement: the amount enters your wallet, available for payout.