How BramaPay Works
Invoice creation, exact-amount matching, settlement, and fulfillment.
Project configuration
A project binds the receiving wallet, secret API key, webhook endpoint, and success/cancel URLs into one integration boundary.
Permanent exact-amount reservation
Invoice creation snapshots the destination and reserves an exact amount for the wallet and token contract. If the requested amount was used before, BramaPay may add a sub-cent token increment. Always display and pay amountCrypto, never reconstruct it from the requested amount.
Blockchain attribution
The current Single Wallet policy matches network, token contract, destination, exact amount, and transaction time. New invoices accept one transfer; partial transfers do not accumulate.
Atomic settlement
A confirmed match updates the invoice, records its settlement, charges the platform fee, records any eligible referral reward, and creates the webhook outbox event atomically.
At-least-once notification
Webhook delivery can repeat. The event ID stays stable while timestamp and attempt change, so the merchant verifies every request and fulfills each event once.
Shared-wallet attribution limitation
An unrelated transfer to the same wallet that exactly matches an eligible invoice's network, token, amount, and time window can be attributed to that invoice. Use dedicated merchant wallet activity and reconcile unexpected transfers operationally.