Collections

Merchant account payment intents

Create a payment intent with a merchant reference and expected amount. Show returned receiving details to the payer, then confirm the payer’s transfer from your backend.

curl -X POST "https://api.example.com/api/merchant/payment-intents" -H "Content-Type: application/json" -H "x-api-key: YOUR_MERCHANT_API_KEY" -d '{"merchantReference":"INV-3021","amount":85000}'

Use merchantReference as your stable reconciliation key. A duplicate reference for the same merchant is rejected.

Dynamic virtual accounts

Create a dynamic virtual account when one payer must send one exact amount. Each request expires after 30 minutes.

curl -X POST "https://api.example.com/api/merchant/virtual-account/dynamic" -H "Content-Type: application/json" -H "x-api-key: YOUR_MERCHANT_API_KEY" -d '{"accountName":"Order INV-1001","amount":50000}'

Persist the returned id, account number, expected amount, and expiry. Query the transaction endpoint or use merchant sync to refresh its status.