Skip to content

Jasa Pembayaran API ​

Jasa Pembayaran is RekberPay's pay-on-behalf service. A buyer who cannot pay a merchant directly (no international card, no supported wallet) asks RekberPay to buy for them. The buyer pays the item price plus a service fee, RekberPay makes the purchase and hands back the result (an account, a receipt, a licence key), and the order is done. If RekberPay does not deliver within the SLA window, the order total is refunded to the buyer's RekberPay balance automatically.

An order has no counterparty: no seller, chat, dispute or shipping. It has its own statuses, so do not reuse escrow endpoints or status names for it.

Endpoints ​

MethodPathEndpointAuth
GET/v1/jasabayar/configGet the service settingsKey or session
POST/v1/jasabayar/quoteQuote the feeKey or session
POST/v1/jasabayarCreate an orderKey or session
GET/v1/jasabayarList ordersKey or session
GET/v1/jasabayar/:idGet an orderKey or session
POST/v1/jasabayar/:id/cancelCancel an orderKey or session
POST/v1/jasabayar/:id/payPay for an orderKey or session
GET/v1/jasabayar/:id/payment-statusGet the order payment statusKey or session
POST/v1/jasabayar/:id/claim-paymentReport a manual transfer for an orderKey or session

Order statuses ​

StatusMeaning
awaiting_paymentCreated, not paid yet. The buyer can still cancel
pending_reviewThe buyer reported a manual transfer. RekberPay is checking it
paidPaid and queued. The SLA clock runs
processingRekberPay is buying. The SLA clock runs
deliveredThe result was handed over
refundedThe order total (item price plus service fee) went back to the buyer's RekberPay balance. A payment method fee is not returned
cancelledCancelled before payment

Get the service settings ​

GET/v1/jasabayar/config

Whether the service is on, the fee rule, the SLA and the price limits.

  • Auth: A personal API key (Authorization: Bearer <key>) or a session cookie with X-CSRF-Token on writes.
  • Rate limit: 300 requests a minute per user, shared by every route.
  • Idempotency: Not needed. Reading has no side effects.

Example request ​

bash
curl https://api.rekberpay.com/v1/jasabayar/config \
  -H "Authorization: Bearer $REKBERPAY_API_KEY"
js
const res = await fetch('https://api.rekberpay.com/v1/jasabayar/config', {
    headers: {
        Authorization: `Bearer ${process.env.REKBERPAY_API_KEY}`,
    },
});
const data = await res.json();
python
import os

import requests

resp = requests.get(
    "https://api.rekberpay.com/v1/jasabayar/config",
    headers={
        "Authorization": f"Bearer {os.environ['REKBERPAY_API_KEY']}",
    },
    timeout=30,
)
print(resp.status_code, resp.json())
php
<?php

$ch = curl_init('https://api.rekberpay.com/v1/jasabayar/config');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('REKBERPAY_API_KEY'),
    ],
]);
$response = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);

Example response ​

200 OK

json
{
    "success": true,
    "data": {
        "enabled": true,
        "fee_type": "percentage",
        "fee_value": 5,
        "fee_min_idr": 5000,
        "fee_max_idr": null,
        "sla_hours": 48,
        "min_item_price_idr": 10000,
        "max_item_price_idr": 10000000
    }
}
FieldTypeDescription
enabledbooleanfalse while the service is off: creating an order answers 503 FEATURE_DISABLED
fee_type, fee_valuestring, numberThe service fee rule: percentage or fixed, and its value
fee_min_idr, fee_max_idrinteger, integer | nullFloor and cap of the service fee (null: no cap)
sla_hoursintegerHours RekberPay has to deliver after payment before the order is refunded automatically
min_item_price_idr, max_item_price_idrintegerThe item price range one order accepts

Errors ​

StatusCodeCause
401UNAUTHORIZED, SESSION_EXPIRED, INVALID_TOKENNo session or API key, the session expired, or the key is wrong or revoked
401WORKSPACE_KEY_ONLYA workspace key (rpe_...) was sent. Those only work under /v1/enterprise
403ACCOUNT_INACTIVE, SUSPENDEDThe account is closed, being deleted or suspended
429RATE_LIMITEDOver the rate limit. Wait for Retry-After seconds

Quote the fee ​

POST/v1/jasabayar/quote

The fee and total for an item price, calculated by RekberPay. This answer uses camelCase field names (itemPrice, serviceFee), unlike the order object.

  • Auth: A personal API key (Authorization: Bearer <key>) or a session cookie with X-CSRF-Token on writes.
  • Rate limit: 300 requests a minute per user, shared by every route.
  • Idempotency: Send an Idempotency-Key header (UUID v4). A retry with the same key and body returns the first answer with Idempotent-Replay: true.

Body (JSON) ​

NameTypeRequiredDescription
item_priceintegerYesRupiah, 0 or more

Example request ​

bash
curl -X POST https://api.rekberpay.com/v1/jasabayar/quote \
  -H "Authorization: Bearer $REKBERPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "item_price": 150000
  }'
js
const res = await fetch('https://api.rekberpay.com/v1/jasabayar/quote', {
    method: 'POST',
    headers: {
        Authorization: `Bearer ${process.env.REKBERPAY_API_KEY}`,
        'Content-Type': 'application/json',
    },
    body: JSON.stringify({
        item_price: 150000
    }),
});
const data = await res.json();
python
import os

import requests

resp = requests.post(
    "https://api.rekberpay.com/v1/jasabayar/quote",
    headers={
        "Authorization": f"Bearer {os.environ['REKBERPAY_API_KEY']}",
    },
    json={
        "item_price": 150000,
    },
    timeout=30,
)
print(resp.status_code, resp.json())
php
<?php

$ch = curl_init('https://api.rekberpay.com/v1/jasabayar/quote');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('REKBERPAY_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'item_price' => 150000,
    ]),
]);
$response = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);

Example response ​

200 OK

json
{
    "success": true,
    "data": {
        "itemPrice": 150000,
        "serviceFee": 7500,
        "total": 157500
    }
}

Errors ​

StatusCodeCause
400INVALID_BODYitem_price is missing or not a whole number
401UNAUTHORIZED, SESSION_EXPIRED, INVALID_TOKENNo session or API key, the session expired, or the key is wrong or revoked
401WORKSPACE_KEY_ONLYA workspace key (rpe_...) was sent. Those only work under /v1/enterprise
403CSRF_FAILEDSession call without the matching X-CSRF-Token header
403ACCOUNT_INACTIVE, SUSPENDEDThe account is closed, being deleted or suspended
429RATE_LIMITEDOver the rate limit. Wait for Retry-After seconds

Create an order ​

POST/v1/jasabayar

Creates an order for the signed-in buyer. RekberPay calculates the fee again; any fee in the request is ignored.

  • Auth: A personal API key (Authorization: Bearer <key>) or a session cookie with X-CSRF-Token on writes.
  • Who can call: Any signed-in user with a confirmed email and a complete profile (name, WhatsApp number and accepted Terms).
  • Rate limit: 300 requests a minute per user, shared by every route.
  • Idempotency: Send an Idempotency-Key header (UUID v4). A retry with the same key and body returns the first answer with Idempotent-Replay: true.

Body (JSON) ​

NameTypeRequiredDescription
target_urlstringYesWhere to buy. http or https only, at most 2,048 characters
target_labelstringNoWhat is being bought, at most 255 characters, no < or >
item_priceintegerYesRupiah, at least min_item_price_idr and at most max_item_price_idr
notesstringNoInstructions for the purchase, at most 3,000 characters

Example request ​

bash
curl -X POST https://api.rekberpay.com/v1/jasabayar \
  -H "Authorization: Bearer $REKBERPAY_API_KEY" \
  -H "Idempotency-Key: 55555552-5555-4555-8555-555555555555" \
  -H "Content-Type: application/json" \
  -d '{
    "target_url": "https://www.tokopedia.com/tokoexample/keyboard-mekanikal-tkl",
    "target_label": "Keyboard mekanikal TKL",
    "item_price": 150000,
    "notes": "Warna hitam, switch brown."
  }'
js
const res = await fetch('https://api.rekberpay.com/v1/jasabayar', {
    method: 'POST',
    headers: {
        Authorization: `Bearer ${process.env.REKBERPAY_API_KEY}`,
        'Content-Type': 'application/json',
        'Idempotency-Key': '55555552-5555-4555-8555-555555555555',
    },
    body: JSON.stringify({
        target_url: "https://www.tokopedia.com/tokoexample/keyboard-mekanikal-tkl",
        target_label: "Keyboard mekanikal TKL",
        item_price: 150000,
        notes: "Warna hitam, switch brown."
    }),
});
const data = await res.json();
python
import os

import requests

resp = requests.post(
    "https://api.rekberpay.com/v1/jasabayar",
    headers={
        "Authorization": f"Bearer {os.environ['REKBERPAY_API_KEY']}",
        "Idempotency-Key": "55555552-5555-4555-8555-555555555555",
    },
    json={
        "target_url": "https://www.tokopedia.com/tokoexample/keyboard-mekanikal-tkl",
        "target_label": "Keyboard mekanikal TKL",
        "item_price": 150000,
        "notes": "Warna hitam, switch brown.",
    },
    timeout=30,
)
print(resp.status_code, resp.json())
php
<?php

$ch = curl_init('https://api.rekberpay.com/v1/jasabayar');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('REKBERPAY_API_KEY'),
        'Content-Type: application/json',
        'Idempotency-Key: 55555552-5555-4555-8555-555555555555',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'target_url' => 'https://www.tokopedia.com/tokoexample/keyboard-mekanikal-tkl',
        'target_label' => 'Keyboard mekanikal TKL',
        'item_price' => 150000,
        'notes' => 'Warna hitam, switch brown.',
    ]),
]);
$response = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);

Example response ​

201 Created

json
{
    "success": true,
    "data": {
        "id": "66666662-6666-4666-8666-666666666666",
        "target_url": "https://www.tokopedia.com/tokoexample/keyboard-mekanikal-tkl",
        "target_label": "Keyboard mekanikal TKL",
        "notes": "Warna hitam, switch brown.",
        "item_price": 150000,
        "service_fee": 7500,
        "total": 157500,
        "status": "awaiting_payment",
        "sla_deadline_at": null,
        "paid_at": null,
        "delivered_at": null,
        "delivery_note": null,
        "has_credentials": false,
        "first_viewed_at": null,
        "refunded_at": null,
        "refund_reason": null,
        "auto_refunded": false,
        "cancelled_at": null,
        "created_at": "2026-10-13T14:23:18.937Z",
        "updated_at": "2026-10-13T14:23:18.937Z"
    }
}

Errors ​

StatusCodeCause
400INVALID_BODYA field failed validation, or target_url is not http or https
400AMOUNT_TOO_LARGEitem_price is above max_item_price_idr
500DB_ERRORThe order was not created and nothing was charged
503FEATURE_DISABLEDThe service is switched off
401UNAUTHORIZED, SESSION_EXPIRED, INVALID_TOKENNo session or API key, the session expired, or the key is wrong or revoked
401WORKSPACE_KEY_ONLYA workspace key (rpe_...) was sent. Those only work under /v1/enterprise
403CSRF_FAILEDSession call without the matching X-CSRF-Token header
403EMAIL_NOT_VERIFIEDYou signed up with email and password and have not confirmed the email yet
409PROFILE_INCOMPLETEThe account has no name or WhatsApp number yet, or has not accepted the Terms
403ACCOUNT_INACTIVE, SUSPENDEDThe account is closed, being deleted or suspended
429RATE_LIMITEDOver the rate limit. Wait for Retry-After seconds

A real AMOUNT_TOO_LARGE answer:

400 Bad Request

json
{
    "success": false,
    "error": {
        "code": "AMOUNT_TOO_LARGE",
        "message": "Nominal maksimum untuk satu pesanan adalah Rp10.000.000."
    }
}

List orders ​

GET/v1/jasabayar

Your orders, newest first.

  • Auth: A personal API key (Authorization: Bearer <key>) or a session cookie with X-CSRF-Token on writes.
  • Rate limit: 300 requests a minute per user, shared by every route.
  • Idempotency: Not needed. Reading has no side effects.

Query parameters ​

NameTypeRequiredDescription
statusstringNoOnly this status
pageintegerNoDefault 1
limitintegerNo1 to 50. Default 20

Example request ​

bash
curl "https://api.rekberpay.com/v1/jasabayar?limit=2" \
  -H "Authorization: Bearer $REKBERPAY_API_KEY"
js
const res = await fetch('https://api.rekberpay.com/v1/jasabayar?limit=2', {
    headers: {
        Authorization: `Bearer ${process.env.REKBERPAY_API_KEY}`,
    },
});
const data = await res.json();
python
import os

import requests

resp = requests.get(
    "https://api.rekberpay.com/v1/jasabayar?limit=2",
    headers={
        "Authorization": f"Bearer {os.environ['REKBERPAY_API_KEY']}",
    },
    timeout=30,
)
print(resp.status_code, resp.json())
php
<?php

$ch = curl_init('https://api.rekberpay.com/v1/jasabayar?limit=2');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('REKBERPAY_API_KEY'),
    ],
]);
$response = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);

Example response ​

200 OK

json
{
    "success": true,
    "data": [
        {
            "id": "aaaaaaa2-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
            "target_url": "https://shopee.co.id/product/123/456",
            "target_label": "Casing HP",
            "notes": "",
            "item_price": 50000,
            "service_fee": 5000,
            "total": 55000,
            "status": "cancelled",
            "sla_deadline_at": null,
            "paid_at": null,
            "delivered_at": null,
            "delivery_note": null,
            "has_credentials": false,
            "first_viewed_at": null,
            "refunded_at": null,
            "refund_reason": null,
            "auto_refunded": false,
            "cancelled_at": "2026-10-13T14:23:18.977Z",
            "created_at": "2026-10-13T14:23:18.973Z",
            "updated_at": "2026-10-13T14:23:18.977Z"
        },
        {
            "id": "66666662-6666-4666-8666-666666666666",
            "target_url": "https://www.tokopedia.com/tokoexample/keyboard-mekanikal-tkl",
            "target_label": "Keyboard mekanikal TKL",
            "notes": "Warna hitam, switch brown.",
            "item_price": 150000,
            "service_fee": 7500,
            "total": 157500,
            "status": "pending_review",
            "sla_deadline_at": null,
            "paid_at": null,
            "delivered_at": null,
            "delivery_note": null,
            "has_credentials": false,
            "first_viewed_at": null,
            "refunded_at": null,
            "refund_reason": null,
            "auto_refunded": false,
            "cancelled_at": null,
            "created_at": "2026-10-13T14:23:18.937Z",
            "updated_at": "2026-10-13T14:23:18.962Z"
        }
    ],
    "pagination": {
        "page": 1,
        "limit": 2,
        "total": 2,
        "total_pages": 1
    }
}

Errors ​

StatusCodeCause
401UNAUTHORIZED, SESSION_EXPIRED, INVALID_TOKENNo session or API key, the session expired, or the key is wrong or revoked
401WORKSPACE_KEY_ONLYA workspace key (rpe_...) was sent. Those only work under /v1/enterprise
403ACCOUNT_INACTIVE, SUSPENDEDThe account is closed, being deleted or suspended
429RATE_LIMITEDOver the rate limit. Wait for Retry-After seconds

Get an order ​

GET/v1/jasabayar/:id

One order with its event history. After delivery the buyer also gets credentials, the delivery details; reading them for the first time sets first_viewed_at.

  • Auth: A personal API key (Authorization: Bearer <key>) or a session cookie with X-CSRF-Token on writes.
  • Who can call: The buyer who created the order.
  • Rate limit: 300 requests a minute per user, shared by every route.
  • Idempotency: Not needed. Reading has no side effects.

Path parameters ​

NameTypeDescription
idUUIDThe order ID

Example request ​

bash
curl https://api.rekberpay.com/v1/jasabayar/66666662-6666-4666-8666-666666666666 \
  -H "Authorization: Bearer $REKBERPAY_API_KEY"
js
const res = await fetch('https://api.rekberpay.com/v1/jasabayar/66666662-6666-4666-8666-666666666666', {
    headers: {
        Authorization: `Bearer ${process.env.REKBERPAY_API_KEY}`,
    },
});
const data = await res.json();
python
import os

import requests

resp = requests.get(
    "https://api.rekberpay.com/v1/jasabayar/66666662-6666-4666-8666-666666666666",
    headers={
        "Authorization": f"Bearer {os.environ['REKBERPAY_API_KEY']}",
    },
    timeout=30,
)
print(resp.status_code, resp.json())
php
<?php

$ch = curl_init('https://api.rekberpay.com/v1/jasabayar/66666662-6666-4666-8666-666666666666');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('REKBERPAY_API_KEY'),
    ],
]);
$response = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);

Example response ​

200 OK

json
{
    "success": true,
    "data": {
        "id": "66666662-6666-4666-8666-666666666666",
        "target_url": "https://www.tokopedia.com/tokoexample/keyboard-mekanikal-tkl",
        "target_label": "Keyboard mekanikal TKL",
        "notes": "Warna hitam, switch brown.",
        "item_price": 150000,
        "service_fee": 7500,
        "total": 157500,
        "status": "awaiting_payment",
        "sla_deadline_at": null,
        "paid_at": null,
        "delivered_at": null,
        "delivery_note": null,
        "has_credentials": false,
        "first_viewed_at": null,
        "refunded_at": null,
        "refund_reason": null,
        "auto_refunded": false,
        "cancelled_at": null,
        "created_at": "2026-10-13T14:23:18.937Z",
        "updated_at": "2026-10-13T14:23:18.937Z",
        "credentials": null,
        "events": [
            {
                "event": "created",
                "message": null,
                "actor_role": "buyer",
                "created_at": "2026-10-13T14:23:18.938Z"
            }
        ]
    }
}

Errors ​

StatusCodeCause
403FORBIDDENThe order belongs to someone else
404NOT_FOUNDNo order with this ID
500DECRYPT_FAILEDThe delivery details could not be opened. Contact support with the order ID
401UNAUTHORIZED, SESSION_EXPIRED, INVALID_TOKENNo session or API key, the session expired, or the key is wrong or revoked
401WORKSPACE_KEY_ONLYA workspace key (rpe_...) was sent. Those only work under /v1/enterprise
403ACCOUNT_INACTIVE, SUSPENDEDThe account is closed, being deleted or suspended
429RATE_LIMITEDOver the rate limit. Wait for Retry-After seconds

Cancel an order ​

POST/v1/jasabayar/:id/cancel

Cancels an order that was not paid. A paid order cannot be cancelled here; contact support. While a payment is still open (a QRIS or virtual account that has not expired, or a manual transfer RekberPay is checking) the cancel is refused with PAYMENT_IN_PROGRESS.

  • Auth: A personal API key (Authorization: Bearer <key>) or a session cookie with X-CSRF-Token on writes.
  • Who can call: The buyer, while the order is awaiting_payment.
  • Rate limit: 300 requests a minute per user, shared by every route.
  • Idempotency: Send an Idempotency-Key header (UUID v4). A retry with the same key and body returns the first answer with Idempotent-Replay: true.

Path parameters ​

NameTypeDescription
idUUIDThe order ID

Example request ​

bash
curl -X POST https://api.rekberpay.com/v1/jasabayar/aaaaaaa2-aaaa-4aaa-8aaa-aaaaaaaaaaaa/cancel \
  -H "Authorization: Bearer $REKBERPAY_API_KEY" \
  -H "Idempotency-Key: bbbbbbb2-bbbb-4bbb-8bbb-bbbbbbbbbbbb" \
  -H "Content-Type: application/json" \
  -d '{}'
js
const res = await fetch('https://api.rekberpay.com/v1/jasabayar/aaaaaaa2-aaaa-4aaa-8aaa-aaaaaaaaaaaa/cancel', {
    method: 'POST',
    headers: {
        Authorization: `Bearer ${process.env.REKBERPAY_API_KEY}`,
        'Content-Type': 'application/json',
        'Idempotency-Key': 'bbbbbbb2-bbbb-4bbb-8bbb-bbbbbbbbbbbb',
    },
    body: JSON.stringify({}),
});
const data = await res.json();
python
import os

import requests

resp = requests.post(
    "https://api.rekberpay.com/v1/jasabayar/aaaaaaa2-aaaa-4aaa-8aaa-aaaaaaaaaaaa/cancel",
    headers={
        "Authorization": f"Bearer {os.environ['REKBERPAY_API_KEY']}",
        "Idempotency-Key": "bbbbbbb2-bbbb-4bbb-8bbb-bbbbbbbbbbbb",
    },
    json={},
    timeout=30,
)
print(resp.status_code, resp.json())
php
<?php

$ch = curl_init('https://api.rekberpay.com/v1/jasabayar/aaaaaaa2-aaaa-4aaa-8aaa-aaaaaaaaaaaa/cancel');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('REKBERPAY_API_KEY'),
        'Content-Type: application/json',
        'Idempotency-Key: bbbbbbb2-bbbb-4bbb-8bbb-bbbbbbbbbbbb',
    ],
    CURLOPT_POSTFIELDS => json_encode(new stdClass()),
]);
$response = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);

Example response ​

200 OK

json
{
    "success": true
}

Errors ​

StatusCodeCause
403FORBIDDENThe order belongs to someone else
404NOT_FOUNDNo order with this ID
409ALREADY_PAIDThe order is past awaiting_payment
409PAYMENT_IN_PROGRESSA payment for this order is still open. Wait until it completes or expires
401UNAUTHORIZED, SESSION_EXPIRED, INVALID_TOKENNo session or API key, the session expired, or the key is wrong or revoked
401WORKSPACE_KEY_ONLYA workspace key (rpe_...) was sent. Those only work under /v1/enterprise
403CSRF_FAILEDSession call without the matching X-CSRF-Token header
403ACCOUNT_INACTIVE, SUSPENDEDThe account is closed, being deleted or suspended
429RATE_LIMITEDOver the rate limit. Wait for Retry-After seconds

A real ALREADY_PAID answer:

409 Conflict

json
{
    "success": false,
    "error": {
        "code": "ALREADY_PAID",
        "message": "Pesanan sudah dibayar dan tidak bisa dibatalkan sendiri. Hubungi support."
    }
}

Pay for an order ​

POST/v1/jasabayar/:id/pay

Starts a payment, exactly like Start a payment for an escrow, with the same answer fields, the same 200 OK with "resumed": true when an open payment is shown again, and the same method-switch rules. The answer names the order total (item price plus service fee) order_amount instead of escrow_amount. The buyer always bears the method fee. A manual bank transfer adds a unique code of Rp1 to Rp999: the buyer transfers pay_total (amount plus unique_code), not amount. See Manual bank transfer and the unique code. Paying from the balance (wallet) answers 201 with payment_link_id, method, provider, status: "paid", order_amount, surcharge, total_amount and new_balance.

  • Auth: A personal API key (Authorization: Bearer <key>) or a session cookie with X-CSRF-Token on writes.
  • Who can call: The buyer, with a confirmed email and a complete profile, while the order is awaiting_payment.
  • Rate limit: 10 payment starts a minute per user, on top of the shared 300 requests a minute.
  • Idempotency: Send an Idempotency-Key header (UUID v4). A retry with the same key and body returns the first answer with Idempotent-Replay: true.

Path parameters ​

NameTypeDescription
idUUIDThe order ID

Body (JSON) ​

NameTypeRequiredDescription
methodstringYesA method from List payment methods, or wallet
providerstringNoA specific gateway
channelstringNoThe virtual account bank for bank_transfer, or the store (alfamart or indomaret) for cstore, as in Start a payment

Example request ​

bash
curl -X POST https://api.rekberpay.com/v1/jasabayar/66666662-6666-4666-8666-666666666666/pay \
  -H "Authorization: Bearer $REKBERPAY_API_KEY" \
  -H "Idempotency-Key: 77777772-7777-4777-8777-777777777777" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "qris"
  }'
js
const res = await fetch('https://api.rekberpay.com/v1/jasabayar/66666662-6666-4666-8666-666666666666/pay', {
    method: 'POST',
    headers: {
        Authorization: `Bearer ${process.env.REKBERPAY_API_KEY}`,
        'Content-Type': 'application/json',
        'Idempotency-Key': '77777772-7777-4777-8777-777777777777',
    },
    body: JSON.stringify({
        method: "qris"
    }),
});
const data = await res.json();
python
import os

import requests

resp = requests.post(
    "https://api.rekberpay.com/v1/jasabayar/66666662-6666-4666-8666-666666666666/pay",
    headers={
        "Authorization": f"Bearer {os.environ['REKBERPAY_API_KEY']}",
        "Idempotency-Key": "77777772-7777-4777-8777-777777777777",
    },
    json={
        "method": "qris",
    },
    timeout=30,
)
print(resp.status_code, resp.json())
php
<?php

$ch = curl_init('https://api.rekberpay.com/v1/jasabayar/66666662-6666-4666-8666-666666666666/pay');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('REKBERPAY_API_KEY'),
        'Content-Type: application/json',
        'Idempotency-Key: 77777772-7777-4777-8777-777777777777',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'method' => 'qris',
    ]),
]);
$response = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);

Example response ​

201 Created

json
{
    "success": true,
    "data": {
        "payment_link_id": "88888882-8888-4888-8888-888888888888",
        "gateway_order_id": "RBP-66666662-1791901398952-e6cc94f7",
        "method": "qris",
        "provider": "manual_qris",
        "qr_code_url": "https://api.rekberpay.com/uploads/escrow/1779846015565_f14a5645.jpg",
        "expires_at": "2026-10-13T15:23:18.952Z",
        "amount": 157500,
        "order_amount": 157500,
        "surcharge": 0,
        "payment_fee": 0,
        "fee_bearer": "buyer",
        "seller_fee": 0
    }
}

Errors ​

StatusCodeCause
400MISSING_METHODNo method in the body
400UNSUPPORTED_METHODNo enabled gateway supports the method
400INVALID_CHANNELchannel is not a bank or store this gateway offers, is missing for cstore, or was sent with wallet
400AMOUNT_OUT_OF_RANGEThe total is outside what this method takes. Pick another method
400WALLET_DISABLEDPaying from the balance is switched off
400BELOW_MIN_AMOUNT, ABOVE_MAX_AMOUNTThe total is outside the balance payment limits
402INSUFFICIENT_BALANCEThe balance does not cover the total
403FORBIDDENThe order belongs to someone else
404NOT_FOUNDNo order with this ID
409INVALID_STATEThe order is not waiting for payment
409INVALID_AMOUNTThe order total is not valid. Contact support
409PROFILE_INCOMPLETEYour account has no name or WhatsApp number yet, or has not accepted the Terms
409PAYMENT_IN_PROGRESSAn earlier QRIS of this order could not be cancelled yet. Use it, or wait until it expires
429TOO_MANY_PAYMENT_LINKSThe order already has 5 open automatic payments
429TOO_MANY_OPEN_PAYMENTSYou have too many open QRIS payments. Finish or cancel one first
500WALLET_ERRORThe balance payment failed. Nothing was charged
502GATEWAY_ERRORThe gateway refused the charge
503NO_GATEWAYS, ADAPTER_NOT_LOADED, GATEWAY_MISCONFIGUREDNo gateway, or not this one, is available right now
503UNIQUE_CODE_BUSYA manual bank transfer found no free unique code for this total. Nothing was charged. Try again in a moment or pick another method
401UNAUTHORIZED, SESSION_EXPIRED, INVALID_TOKENNo session or API key, the session expired, or the key is wrong or revoked
401WORKSPACE_KEY_ONLYA workspace key (rpe_...) was sent. Those only work under /v1/enterprise
403CSRF_FAILEDSession call without the matching X-CSRF-Token header
403EMAIL_NOT_VERIFIEDYou signed up with email and password and have not confirmed the email yet
403ACCOUNT_INACTIVE, SUSPENDEDThe account is closed, being deleted or suspended
429RATE_LIMITEDOver the rate limit. Wait for Retry-After seconds

Get the order payment status ​

GET/v1/jasabayar/:id/payment-status

The latest payment attempt for the order. Same fields and statuses as the escrow payment status, with escrow_id: null. Poll it the same way. A manual bank transfer also has pay_total and unique_code: show pay_total as the figure to transfer.

  • Auth: A personal API key (Authorization: Bearer <key>) or a session cookie with X-CSRF-Token on writes.
  • Who can call: The buyer.
  • Rate limit: 300 requests a minute per user, shared by every route.
  • Idempotency: Not needed. Reading has no side effects.

Path parameters ​

NameTypeDescription
idUUIDThe order ID

Example request ​

bash
curl https://api.rekberpay.com/v1/jasabayar/66666662-6666-4666-8666-666666666666/payment-status \
  -H "Authorization: Bearer $REKBERPAY_API_KEY"
js
const res = await fetch('https://api.rekberpay.com/v1/jasabayar/66666662-6666-4666-8666-666666666666/payment-status', {
    headers: {
        Authorization: `Bearer ${process.env.REKBERPAY_API_KEY}`,
    },
});
const data = await res.json();
python
import os

import requests

resp = requests.get(
    "https://api.rekberpay.com/v1/jasabayar/66666662-6666-4666-8666-666666666666/payment-status",
    headers={
        "Authorization": f"Bearer {os.environ['REKBERPAY_API_KEY']}",
    },
    timeout=30,
)
print(resp.status_code, resp.json())
php
<?php

$ch = curl_init('https://api.rekberpay.com/v1/jasabayar/66666662-6666-4666-8666-666666666666/payment-status');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('REKBERPAY_API_KEY'),
    ],
]);
$response = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);

Example response ​

200 OK

json
{
    "success": true,
    "data": {
        "id": "88888882-8888-4888-8888-888888888888",
        "escrow_id": null,
        "provider": "manual_qris",
        "method": "qris",
        "gateway_order_id": "RBP-66666662-1791901398952-e6cc94f7",
        "amount": "157500.00",
        "status": "pending",
        "qr_url": "https://api.rekberpay.com/uploads/escrow/1779846015565_f14a5645.jpg",
        "va_number": null,
        "redirect_url": null,
        "expires_at": "2026-10-13T15:23:18.952Z",
        "created_at": "2026-10-13T14:23:18.952Z",
        "updated_at": "2026-10-13T14:23:18.952Z",
        "paid_at": null,
        "surcharge_idr": "0.00",
        "surcharge_bearer": "buyer"
    }
}

Errors ​

StatusCodeCause
403FORBIDDENThe order belongs to someone else
404NOT_FOUNDNo order with this ID
404NO_PAYMENTNo payment was started yet
401UNAUTHORIZED, SESSION_EXPIRED, INVALID_TOKENNo session or API key, the session expired, or the key is wrong or revoked
401WORKSPACE_KEY_ONLYA workspace key (rpe_...) was sent. Those only work under /v1/enterprise
403ACCOUNT_INACTIVE, SUSPENDEDThe account is closed, being deleted or suspended
429RATE_LIMITEDOver the rate limit. Wait for Retry-After seconds

Report a manual transfer for an order ​

POST/v1/jasabayar/:id/claim-payment

After paying with manual QRIS or bank transfer, the buyer reports it. The order moves to pending_review until RekberPay confirms the money. Send {} as the body.

  • Auth: A personal API key (Authorization: Bearer <key>) or a session cookie with X-CSRF-Token on writes.
  • Who can call: The buyer.
  • Rate limit: 300 requests a minute per user, shared by every route.
  • Idempotency: Send an Idempotency-Key header (UUID v4). A retry with the same key and body returns the first answer with Idempotent-Replay: true.

Path parameters ​

NameTypeDescription
idUUIDThe order ID

Example request ​

bash
curl -X POST https://api.rekberpay.com/v1/jasabayar/66666662-6666-4666-8666-666666666666/claim-payment \
  -H "Authorization: Bearer $REKBERPAY_API_KEY" \
  -H "Idempotency-Key: 99999992-9999-4999-8999-999999999999" \
  -H "Content-Type: application/json" \
  -d '{}'
js
const res = await fetch('https://api.rekberpay.com/v1/jasabayar/66666662-6666-4666-8666-666666666666/claim-payment', {
    method: 'POST',
    headers: {
        Authorization: `Bearer ${process.env.REKBERPAY_API_KEY}`,
        'Content-Type': 'application/json',
        'Idempotency-Key': '99999992-9999-4999-8999-999999999999',
    },
    body: JSON.stringify({}),
});
const data = await res.json();
python
import os

import requests

resp = requests.post(
    "https://api.rekberpay.com/v1/jasabayar/66666662-6666-4666-8666-666666666666/claim-payment",
    headers={
        "Authorization": f"Bearer {os.environ['REKBERPAY_API_KEY']}",
        "Idempotency-Key": "99999992-9999-4999-8999-999999999999",
    },
    json={},
    timeout=30,
)
print(resp.status_code, resp.json())
php
<?php

$ch = curl_init('https://api.rekberpay.com/v1/jasabayar/66666662-6666-4666-8666-666666666666/claim-payment');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('REKBERPAY_API_KEY'),
        'Content-Type: application/json',
        'Idempotency-Key: 99999992-9999-4999-8999-999999999999',
    ],
    CURLOPT_POSTFIELDS => json_encode(new stdClass()),
]);
$response = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);

Example response ​

200 OK

json
{
    "success": true,
    "data": {
        "status": "pending_review"
    }
}

Errors ​

StatusCodeCause
403NOT_BUYEROnly the buyer can claim
404NOT_FOUNDNo order with this ID
409NO_MANUAL_PAYMENTThere is no manual payment waiting
409INVALID_STATEThe order is no longer awaiting_payment
401UNAUTHORIZED, SESSION_EXPIRED, INVALID_TOKENNo session or API key, the session expired, or the key is wrong or revoked
401WORKSPACE_KEY_ONLYA workspace key (rpe_...) was sent. Those only work under /v1/enterprise
403CSRF_FAILEDSession call without the matching X-CSRF-Token header
403EMAIL_NOT_VERIFIEDYou signed up with email and password and have not confirmed the email yet
403ACCOUNT_INACTIVE, SUSPENDEDThe account is closed, being deleted or suspended
429RATE_LIMITEDOver the rate limit. Wait for Retry-After seconds

Order object ​

FieldTypeDescription
idUUIDOrder ID
target_urlstringWhere to buy, normalised
target_labelstring | nullWhat is being bought
notesstringInstructions for the purchase
item_priceintegerItem price in rupiah
service_feeintegerRekberPay's fee
totalintegerWhat the buyer pays: item_price + service_fee
statusstringSee Order statuses
sla_deadline_atstring | nullAfter this time an undelivered order is refunded automatically
paid_at, delivered_at, refunded_at, cancelled_atstring | nullWhen each step happened
delivery_notestring | nullRekberPay's note on delivery
has_credentialsbooleanWhether delivery details exist. They are returned only by Get an order
first_viewed_atstring | nullWhen the buyer first opened the delivery details
refund_reasonstring | nullWhy it was refunded
auto_refundedbooleantrue when the refund was automatic because the SLA ran out
created_at, updated_atstringWhen the order was made and last changed
credentialsstring | nullOnly on Get an order, only for the buyer: the delivery details, once RekberPay delivered
eventsarrayOnly on Get an order: the order history, oldest first, up to 100 items of event, message, actor_role (buyer, admin or system) and created_at

Escrow, payment services and B2B deals for Indonesian businesses.