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
| Method | Path | Endpoint | Auth |
|---|---|---|---|
GET | /v1/jasabayar/config | Get the service settings | Key or session |
POST | /v1/jasabayar/quote | Quote the fee | Key or session |
POST | /v1/jasabayar | Create an order | Key or session |
GET | /v1/jasabayar | List orders | Key or session |
GET | /v1/jasabayar/:id | Get an order | Key or session |
POST | /v1/jasabayar/:id/cancel | Cancel an order | Key or session |
POST | /v1/jasabayar/:id/pay | Pay for an order | Key or session |
GET | /v1/jasabayar/:id/payment-status | Get the order payment status | Key or session |
POST | /v1/jasabayar/:id/claim-payment | Report a manual transfer for an order | Key or session |
Order statuses
| Status | Meaning |
|---|---|
awaiting_payment | Created, not paid yet. The buyer can still cancel |
pending_review | The buyer reported a manual transfer. RekberPay is checking it |
paid | Paid and queued. The SLA clock runs |
processing | RekberPay is buying. The SLA clock runs |
delivered | The result was handed over |
refunded | The order total (item price plus service fee) went back to the buyer's RekberPay balance. A payment method fee is not returned |
cancelled | Cancelled before payment |
Get the service settings
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 withX-CSRF-Tokenon writes. - Rate limit: 300 requests a minute per user, shared by every route.
- Idempotency: Not needed. Reading has no side effects.
Example request
curl https://api.rekberpay.com/v1/jasabayar/config \
-H "Authorization: Bearer $REKBERPAY_API_KEY"const res = await fetch('https://api.rekberpay.com/v1/jasabayar/config', {
headers: {
Authorization: `Bearer ${process.env.REKBERPAY_API_KEY}`,
},
});
const data = await res.json();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
$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
{
"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
}
}| Field | Type | Description |
|---|---|---|
enabled | boolean | false while the service is off: creating an order answers 503 FEATURE_DISABLED |
fee_type, fee_value | string, number | The service fee rule: percentage or fixed, and its value |
fee_min_idr, fee_max_idr | integer, integer | null | Floor and cap of the service fee (null: no cap) |
sla_hours | integer | Hours RekberPay has to deliver after payment before the order is refunded automatically |
min_item_price_idr, max_item_price_idr | integer | The item price range one order accepts |
Errors
| Status | Code | Cause |
|---|---|---|
401 | UNAUTHORIZED, SESSION_EXPIRED, INVALID_TOKEN | No session or API key, the session expired, or the key is wrong or revoked |
401 | WORKSPACE_KEY_ONLY | A workspace key (rpe_...) was sent. Those only work under /v1/enterprise |
403 | ACCOUNT_INACTIVE, SUSPENDED | The account is closed, being deleted or suspended |
429 | RATE_LIMITED | Over the rate limit. Wait for Retry-After seconds |
Quote the fee
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 withX-CSRF-Tokenon writes. - Rate limit: 300 requests a minute per user, shared by every route.
- Idempotency: Send an
Idempotency-Keyheader (UUID v4). A retry with the same key and body returns the first answer withIdempotent-Replay: true.
Body (JSON)
| Name | Type | Required | Description |
|---|---|---|---|
item_price | integer | Yes | Rupiah, 0 or more |
Example request
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
}'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();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
$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
{
"success": true,
"data": {
"itemPrice": 150000,
"serviceFee": 7500,
"total": 157500
}
}Errors
| Status | Code | Cause |
|---|---|---|
400 | INVALID_BODY | item_price is missing or not a whole number |
401 | UNAUTHORIZED, SESSION_EXPIRED, INVALID_TOKEN | No session or API key, the session expired, or the key is wrong or revoked |
401 | WORKSPACE_KEY_ONLY | A workspace key (rpe_...) was sent. Those only work under /v1/enterprise |
403 | CSRF_FAILED | Session call without the matching X-CSRF-Token header |
403 | ACCOUNT_INACTIVE, SUSPENDED | The account is closed, being deleted or suspended |
429 | RATE_LIMITED | Over the rate limit. Wait for Retry-After seconds |
Create an order
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 withX-CSRF-Tokenon 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-Keyheader (UUID v4). A retry with the same key and body returns the first answer withIdempotent-Replay: true.
Body (JSON)
| Name | Type | Required | Description |
|---|---|---|---|
target_url | string | Yes | Where to buy. http or https only, at most 2,048 characters |
target_label | string | No | What is being bought, at most 255 characters, no < or > |
item_price | integer | Yes | Rupiah, at least min_item_price_idr and at most max_item_price_idr |
notes | string | No | Instructions for the purchase, at most 3,000 characters |
Example request
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."
}'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();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
$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
{
"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
| Status | Code | Cause |
|---|---|---|
400 | INVALID_BODY | A field failed validation, or target_url is not http or https |
400 | AMOUNT_TOO_LARGE | item_price is above max_item_price_idr |
500 | DB_ERROR | The order was not created and nothing was charged |
503 | FEATURE_DISABLED | The service is switched off |
401 | UNAUTHORIZED, SESSION_EXPIRED, INVALID_TOKEN | No session or API key, the session expired, or the key is wrong or revoked |
401 | WORKSPACE_KEY_ONLY | A workspace key (rpe_...) was sent. Those only work under /v1/enterprise |
403 | CSRF_FAILED | Session call without the matching X-CSRF-Token header |
403 | EMAIL_NOT_VERIFIED | You signed up with email and password and have not confirmed the email yet |
409 | PROFILE_INCOMPLETE | The account has no name or WhatsApp number yet, or has not accepted the Terms |
403 | ACCOUNT_INACTIVE, SUSPENDED | The account is closed, being deleted or suspended |
429 | RATE_LIMITED | Over the rate limit. Wait for Retry-After seconds |
A real AMOUNT_TOO_LARGE answer:
400 Bad Request
{
"success": false,
"error": {
"code": "AMOUNT_TOO_LARGE",
"message": "Nominal maksimum untuk satu pesanan adalah Rp10.000.000."
}
}List orders
Your orders, newest first.
- Auth: A personal API key (
Authorization: Bearer <key>) or a session cookie withX-CSRF-Tokenon writes. - Rate limit: 300 requests a minute per user, shared by every route.
- Idempotency: Not needed. Reading has no side effects.
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
status | string | No | Only this status |
page | integer | No | Default 1 |
limit | integer | No | 1 to 50. Default 20 |
Example request
curl "https://api.rekberpay.com/v1/jasabayar?limit=2" \
-H "Authorization: Bearer $REKBERPAY_API_KEY"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();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
$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
{
"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
| Status | Code | Cause |
|---|---|---|
401 | UNAUTHORIZED, SESSION_EXPIRED, INVALID_TOKEN | No session or API key, the session expired, or the key is wrong or revoked |
401 | WORKSPACE_KEY_ONLY | A workspace key (rpe_...) was sent. Those only work under /v1/enterprise |
403 | ACCOUNT_INACTIVE, SUSPENDED | The account is closed, being deleted or suspended |
429 | RATE_LIMITED | Over the rate limit. Wait for Retry-After seconds |
Get an order
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 withX-CSRF-Tokenon 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
| Name | Type | Description |
|---|---|---|
id | UUID | The order ID |
Example request
curl https://api.rekberpay.com/v1/jasabayar/66666662-6666-4666-8666-666666666666 \
-H "Authorization: Bearer $REKBERPAY_API_KEY"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();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
$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
{
"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
| Status | Code | Cause |
|---|---|---|
403 | FORBIDDEN | The order belongs to someone else |
404 | NOT_FOUND | No order with this ID |
500 | DECRYPT_FAILED | The delivery details could not be opened. Contact support with the order ID |
401 | UNAUTHORIZED, SESSION_EXPIRED, INVALID_TOKEN | No session or API key, the session expired, or the key is wrong or revoked |
401 | WORKSPACE_KEY_ONLY | A workspace key (rpe_...) was sent. Those only work under /v1/enterprise |
403 | ACCOUNT_INACTIVE, SUSPENDED | The account is closed, being deleted or suspended |
429 | RATE_LIMITED | Over the rate limit. Wait for Retry-After seconds |
Cancel an order
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 withX-CSRF-Tokenon 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-Keyheader (UUID v4). A retry with the same key and body returns the first answer withIdempotent-Replay: true.
Path parameters
| Name | Type | Description |
|---|---|---|
id | UUID | The order ID |
Example request
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 '{}'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();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
$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
{
"success": true
}Errors
| Status | Code | Cause |
|---|---|---|
403 | FORBIDDEN | The order belongs to someone else |
404 | NOT_FOUND | No order with this ID |
409 | ALREADY_PAID | The order is past awaiting_payment |
409 | PAYMENT_IN_PROGRESS | A payment for this order is still open. Wait until it completes or expires |
401 | UNAUTHORIZED, SESSION_EXPIRED, INVALID_TOKEN | No session or API key, the session expired, or the key is wrong or revoked |
401 | WORKSPACE_KEY_ONLY | A workspace key (rpe_...) was sent. Those only work under /v1/enterprise |
403 | CSRF_FAILED | Session call without the matching X-CSRF-Token header |
403 | ACCOUNT_INACTIVE, SUSPENDED | The account is closed, being deleted or suspended |
429 | RATE_LIMITED | Over the rate limit. Wait for Retry-After seconds |
A real ALREADY_PAID answer:
409 Conflict
{
"success": false,
"error": {
"code": "ALREADY_PAID",
"message": "Pesanan sudah dibayar dan tidak bisa dibatalkan sendiri. Hubungi support."
}
}Pay for an order
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 withX-CSRF-Tokenon 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-Keyheader (UUID v4). A retry with the same key and body returns the first answer withIdempotent-Replay: true.
Path parameters
| Name | Type | Description |
|---|---|---|
id | UUID | The order ID |
Body (JSON)
| Name | Type | Required | Description |
|---|---|---|---|
method | string | Yes | A method from List payment methods, or wallet |
provider | string | No | A specific gateway |
channel | string | No | The virtual account bank for bank_transfer, or the store (alfamart or indomaret) for cstore, as in Start a payment |
Example request
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"
}'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();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
$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
{
"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
| Status | Code | Cause |
|---|---|---|
400 | MISSING_METHOD | No method in the body |
400 | UNSUPPORTED_METHOD | No enabled gateway supports the method |
400 | INVALID_CHANNEL | channel is not a bank or store this gateway offers, is missing for cstore, or was sent with wallet |
400 | AMOUNT_OUT_OF_RANGE | The total is outside what this method takes. Pick another method |
400 | WALLET_DISABLED | Paying from the balance is switched off |
400 | BELOW_MIN_AMOUNT, ABOVE_MAX_AMOUNT | The total is outside the balance payment limits |
402 | INSUFFICIENT_BALANCE | The balance does not cover the total |
403 | FORBIDDEN | The order belongs to someone else |
404 | NOT_FOUND | No order with this ID |
409 | INVALID_STATE | The order is not waiting for payment |
409 | INVALID_AMOUNT | The order total is not valid. Contact support |
409 | PROFILE_INCOMPLETE | Your account has no name or WhatsApp number yet, or has not accepted the Terms |
409 | PAYMENT_IN_PROGRESS | An earlier QRIS of this order could not be cancelled yet. Use it, or wait until it expires |
429 | TOO_MANY_PAYMENT_LINKS | The order already has 5 open automatic payments |
429 | TOO_MANY_OPEN_PAYMENTS | You have too many open QRIS payments. Finish or cancel one first |
500 | WALLET_ERROR | The balance payment failed. Nothing was charged |
502 | GATEWAY_ERROR | The gateway refused the charge |
503 | NO_GATEWAYS, ADAPTER_NOT_LOADED, GATEWAY_MISCONFIGURED | No gateway, or not this one, is available right now |
503 | UNIQUE_CODE_BUSY | A manual bank transfer found no free unique code for this total. Nothing was charged. Try again in a moment or pick another method |
401 | UNAUTHORIZED, SESSION_EXPIRED, INVALID_TOKEN | No session or API key, the session expired, or the key is wrong or revoked |
401 | WORKSPACE_KEY_ONLY | A workspace key (rpe_...) was sent. Those only work under /v1/enterprise |
403 | CSRF_FAILED | Session call without the matching X-CSRF-Token header |
403 | EMAIL_NOT_VERIFIED | You signed up with email and password and have not confirmed the email yet |
403 | ACCOUNT_INACTIVE, SUSPENDED | The account is closed, being deleted or suspended |
429 | RATE_LIMITED | Over the rate limit. Wait for Retry-After seconds |
Get the order 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 withX-CSRF-Tokenon 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
| Name | Type | Description |
|---|---|---|
id | UUID | The order ID |
Example request
curl https://api.rekberpay.com/v1/jasabayar/66666662-6666-4666-8666-666666666666/payment-status \
-H "Authorization: Bearer $REKBERPAY_API_KEY"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();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
$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
{
"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
| Status | Code | Cause |
|---|---|---|
403 | FORBIDDEN | The order belongs to someone else |
404 | NOT_FOUND | No order with this ID |
404 | NO_PAYMENT | No payment was started yet |
401 | UNAUTHORIZED, SESSION_EXPIRED, INVALID_TOKEN | No session or API key, the session expired, or the key is wrong or revoked |
401 | WORKSPACE_KEY_ONLY | A workspace key (rpe_...) was sent. Those only work under /v1/enterprise |
403 | ACCOUNT_INACTIVE, SUSPENDED | The account is closed, being deleted or suspended |
429 | RATE_LIMITED | Over the rate limit. Wait for Retry-After seconds |
Report a manual transfer for an order
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 withX-CSRF-Tokenon writes. - Who can call: The buyer.
- Rate limit: 300 requests a minute per user, shared by every route.
- Idempotency: Send an
Idempotency-Keyheader (UUID v4). A retry with the same key and body returns the first answer withIdempotent-Replay: true.
Path parameters
| Name | Type | Description |
|---|---|---|
id | UUID | The order ID |
Example request
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 '{}'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();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
$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
{
"success": true,
"data": {
"status": "pending_review"
}
}Errors
| Status | Code | Cause |
|---|---|---|
403 | NOT_BUYER | Only the buyer can claim |
404 | NOT_FOUND | No order with this ID |
409 | NO_MANUAL_PAYMENT | There is no manual payment waiting |
409 | INVALID_STATE | The order is no longer awaiting_payment |
401 | UNAUTHORIZED, SESSION_EXPIRED, INVALID_TOKEN | No session or API key, the session expired, or the key is wrong or revoked |
401 | WORKSPACE_KEY_ONLY | A workspace key (rpe_...) was sent. Those only work under /v1/enterprise |
403 | CSRF_FAILED | Session call without the matching X-CSRF-Token header |
403 | EMAIL_NOT_VERIFIED | You signed up with email and password and have not confirmed the email yet |
403 | ACCOUNT_INACTIVE, SUSPENDED | The account is closed, being deleted or suspended |
429 | RATE_LIMITED | Over the rate limit. Wait for Retry-After seconds |
Order object
| Field | Type | Description |
|---|---|---|
id | UUID | Order ID |
target_url | string | Where to buy, normalised |
target_label | string | null | What is being bought |
notes | string | Instructions for the purchase |
item_price | integer | Item price in rupiah |
service_fee | integer | RekberPay's fee |
total | integer | What the buyer pays: item_price + service_fee |
status | string | See Order statuses |
sla_deadline_at | string | null | After this time an undelivered order is refunded automatically |
paid_at, delivered_at, refunded_at, cancelled_at | string | null | When each step happened |
delivery_note | string | null | RekberPay's note on delivery |
has_credentials | boolean | Whether delivery details exist. They are returned only by Get an order |
first_viewed_at | string | null | When the buyer first opened the delivery details |
refund_reason | string | null | Why it was refunded |
auto_refunded | boolean | true when the refund was automatic because the SLA ran out |
created_at, updated_at | string | When the order was made and last changed |
credentials | string | null | Only on Get an order, only for the buyer: the delivery details, once RekberPay delivered |
events | array | Only 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 |