Escrow API
Hold the buyer's money until the order is done.
- Create an escrow from an HMAC-signed link
- Hosted checkout with QRIS and bank transfer
- Poll payment status until the money is held
Hold buyer payments in escrow, sell payment services and run B2B milestone deals from your own backend.
https://api.rekberpay.com/v1{
"success": true,
"data": {
"id": "7f8a9b0c-1d2e-4f3a-8b6c-7d8e9f0a1b2c",
"status": "pending_payment",
"amount": "22500000.00",
"partner_ref": "MARKETPLACE_98765"
}
}Three APIs on one account. Pick the one that matches your flow.
Hold the buyer's money until the order is done.
Let buyers pay merchants they cannot pay directly.
Run supplier deals as funded milestones with your team.
From Sandbox to a live milestone deal. Every guide shows the dashboard steps and the API calls side by side.
Open the workspace in Sandbox, invite your team and choose roles.
Four short KYB steps, then unlock Live.
Fund, deliver, approve and release, sandbox first.
curl -X POST https://api.rekberpay.com/v1/enterprise/deals \
-H "Authorization: Bearer $REKBERPAY_WORKSPACE_KEY" \
-H "Idempotency-Key: 6f9619ff-8b86-4d11-b42d-00c04fc964ff" \
-H "Content-Type: application/json" \
-d '{
"title": "Packaging order, Q4",
"counterparty_id": "<counterparty id>",
"funding_mode": "per_milestone",
"fee_allocation": "split",
"fee_buyer_percent": 60,
"milestones": [
{ "title": "Deposit", "amount": 30000000 },
{ "title": "Delivery", "amount": 70000000 }
]
}'From a signed link to a paid escrow. The full walkthrough is in the Quickstart.
POST the signed link, which carries the amount, to /v1/escrows/from-link with an Idempotency-Key.
Send the buyer to rekberpay.com/escrow/<id>/pay, then poll payment-status until it reads paid.
GET /v1/escrows/:id returns the full state and timestamps.
curl -X POST https://api.rekberpay.com/v1/escrows/from-link \
-H "Authorization: Bearer $BUYER_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \
-d '{
"link": "https://rekberpay.com/?amount=22500000&category=goods&expires=1792466500&item=iPhone%2015%20Pro%20256GB&ref=MARKETPLACE_98765&seller=0a1b2c3d-4e5f-4a7b-8c9d-0e1f2a3b4c5d&v=1&sig=<hex signature>"
}'GET /v1/escrows/:id/payment-status
Authorization: Bearer <your-api-key>Every request is made as a signed-in RekberPay user.
For server-to-server calls. The key acts as the user who created it.
Authorization: Bearer <api-key>For the dashboard in a browser. Writes also need the CSRF token.
Cookie: __Host-rekber_session=...
X-CSRF-Token: <token>Enterprise only. Picks the workspace when a user belongs to several.
X-Enterprise-Account: <workspace-id>