Skip to content
REST API v1

RekberPay API

Hold buyer payments in escrow, sell payment services and run B2B milestone deals from your own backend.

Base URL
https://api.rekberpay.com/v1
Format
JSON, amounts in IDR
POST/v1/escrows/from-link201 Created
json
{
    "success": true,
    "data": {
        "id": "7f8a9b0c-1d2e-4f3a-8b6c-7d8e9f0a1b2c",
        "status": "pending_payment",
        "amount": "22500000.00",
        "partner_ref": "MARKETPLACE_98765"
    }
}

Products

Three APIs on one account. Pick the one that matches your flow.

Marketplaces

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
Escrow reference
Pay on behalf

Jasa Pembayaran

Let buyers pay merchants they cannot pay directly.

  • Quote the service fee before the order
  • Track each order from payment to delivery
  • Full refund when delivery misses the SLA
Jasa Pembayaran reference
B2B workspace

Enterprise

Run supplier deals as funded milestones with your team.

  • Milestone deals with four-eyes approvals
  • Payouts only to verified payout instructions
  • Event feed and audit export for finance
Enterprise reference

Enterprise in four steps

From Sandbox to a live milestone deal. Every guide shows the dashboard steps and the API calls side by side.

Start the guides
  1. Open a workspace

    Open the workspace in Sandbox, invite your team and choose roles.

  2. Verify the business

    Four short KYB steps, then unlock Live.

  3. Link partners and agree the fee

    Link a partner workspace and agree who pays.

  4. Run the deal

    Fund, deliver, approve and release, sandbox first.

bash
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 }
    ]
  }'

Quickstart in three calls

From a signed link to a paid escrow. The full walkthrough is in the Quickstart.

Open the Quickstart
  1. Create the escrow

    POST the signed link, which carries the amount, to /v1/escrows/from-link with an Idempotency-Key.

  2. Poll the payment

    Send the buyer to rekberpay.com/escrow/<id>/pay, then poll payment-status until it reads paid.

  3. Read the escrow

    GET /v1/escrows/:id returns the full state and timestamps.

bash
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>"
  }'
http
GET /v1/escrows/:id/payment-status
Authorization: Bearer <your-api-key>

Authentication

Every request is made as a signed-in RekberPay user.

How authentication works

Bearer API key

For server-to-server calls. The key acts as the user who created it.

Authorization: Bearer <api-key>

Session cookie

For the dashboard in a browser. Writes also need the CSRF token.

Cookie: __Host-rekber_session=...
X-CSRF-Token: <token>

Workspace header

Enterprise only. Picks the workspace when a user belongs to several.

X-Enterprise-Account: <workspace-id>

Escrow, payment services and B2B deals for Indonesian businesses.