Skip to content

Errors ​

Every error response from the RekberPay API follows the same shape:

json
{
    "success": false,
    "error": {
        "code": "SIG_MISMATCH",
        "message": "Signature verification failed."
    }
}

Errors raised by the framework (a body over 1 MiB, a rate limit, an unexpected failure) also carry a requestId next to error. Quote it when you contact support. A real rate limit answer:

json
{
    "success": false,
    "requestId": "5f0c2a3e-7b1d-4c8e-9a2f-3d6b1e4c7a90",
    "error": {
        "code": "RATE_LIMITED",
        "message": "Too many requests. Try again in 60s."
    }
}

Each endpoint in the API reference lists the codes it can return. This page collects the shared ones. The Errors and rate limits guide shows how to handle them.

The HTTP status code tells you the category. The code field gives you something stable to switch on.

HTTP status categories ​

StatusCategoryRetry?
400Validation / bad inputNo, fix the input
401UnauthenticatedNo, log in / get credentials
403ForbiddenNo, fix permissions
404Not foundNo
409Conflict (duplicate, wrong state, an Idempotency-Key still in flight, a write that collided)Maybe, see specific code
410Gone (expired)No
413Payload too largeNo, shrink the body
422A signed link or a business rule was rejected (bad signature, expired link, unknown seller), or an Idempotency-Key reused with another bodyNo, fix the input
423Sign-in locked after failed attemptsLater
429Rate limitedYes, back off
500Internal errorYes, retry with same idempotency key
502 / 503Upstream gateway downYes, retry with backoff

Error codes ​

Authentication & signing ​

CodeStatusCauseRecovery
SIG_MISMATCH422sig does not match the canonical stringRe-sign with the correct field order, encoding and secret
SIG_INCOMPLETE422A signed link is missing amount, ref, expires or vAdd the missing parameter and sign again
UNSUPPORTED_SIG_VERSION422v is not 1Send v=1
INVALID_AMOUNT422On POST /v1/escrows/from-link, the signed amount is not plain digits from 1000 to 500000000Sign a whole rupiah amount with no decimals, separators or leading zero
AMOUNT_MISMATCH422The amount in the request body is not the signed amountLeave amount out of the body, or send exactly the signed value
HOST_NOT_ALLOWED422The link host is not rekberpay.com or an enabled partner hostBuild the link on an allowed host
INVALID_EXPIRES422expires is not a unix timestampSend seconds since epoch
LINK_EXPIRED422expires is in the pastGenerate a fresh link with a future expires
EXPIRES_TOO_FAR422expires is more than 30 days awayUse 30 days or less
INVALID_REF422ref is longer than 64 charactersSign a shorter order reference
LINK_ALREADY_USED409A single-use link (one with buyer) was already used and its escrow no longer existsSign a new link with a new ref
LINK_USE_LIMITED429One buyer made 3 escrows from the same catalogue link within 10 minutesWait a few minutes, or sign a link with buyer for one order
SIGNATURE_REQUIRED400Partner parameters, amount included, present without a sigSign the link. Unsigned partner links are rejected
UNAUTHORIZED401No session and no API keySign in or send Authorization: Bearer <key>
SESSION_EXPIRED401The session cookie is no longer validSign in again
INVALID_TOKEN401The API key is wrong or was revoked (a personal key by a rotation; a workspace key by an admin, or because its creator left the workspace)Use the newest key
WORKSPACE_KEY_ONLY401A workspace key (rpe_...) was sent outside /v1/enterpriseUse a personal key for consumer routes
KEY_IP_NOT_ALLOWED401A workspace key with an IP allowlist was used from an address that is not on itCall from a listed server, or change the key's allowed IPs in the dashboard
KEY_IN_BROWSER403A workspace key was sent from a browser (the request had an Origin or Sec-Fetch-Site header)Call the API from your server only
TURNSTILE_FAILED403 (400 on sign-in)The Cloudflare Turnstile check did not passComplete the check again and resend
CSRF_FAILED403A session write without the matching X-CSRF-TokenSend the csrf_token from sign-in
INVALID_CREDENTIALS401Wrong email or password on sign-inCheck the credentials
ACCOUNT_LOCKED423Too many failed sign-insWait and try again
LOGIN_LOCKED429Too many failed sign-ins from this addressWait for Retry-After

Idempotency ​

CodeStatusCauseRecovery
IDEMPOTENCY_KEY_INVALID400Header value isn't a UUID v4Use randomUUID() / uuid.uuid4()
IDEMPOTENCY_KEY_CONFLICT422Same key, different request bodyGenerate a fresh key for the new operation
IDEMPOTENCY_KEY_IN_FLIGHT409An earlier request with this key is still processingWait and retry the same key; do not generate a new one
IDEMPOTENCY_LOOKUP_FAILED500The key could not be checkedRetry with the same key
IDEMPOTENCY_INSERT_FAILED500Key could not be registeredRetry with the same key

Validation ​

CodeStatusCauseRecovery
INVALID_BODY400Body failed Zod schema validationCheck required fields and types
INVALID_AMOUNT400?amount= on the fee estimate is outside 1,000 to 500,000,000 IDR, or a Jasa Pembayaran order has no valid totalUse an amount in range. On POST /v1/escrows/from-link a bad signed amount is 422 INVALID_AMOUNT (see above) and a bad body amount is 400 INVALID_BODY
INVALID_METHOD400Withdrawal method not recognizedUse a method the withdrawal form offers
MISSING_METHOD400No method suppliedSend a method from /v1/gateways/available-methods
UNSUPPORTED_METHOD400No enabled gateway serves this method right nowRe-fetch /v1/gateways/available-methods and pick another
INVALID_USERNAME400Username doesn't match ^[a-z0-9_.]{3,30}$Lowercase alphanumeric + underscore/dot
WEAK_PASSWORD400Password fails the policy: 10 to 128 characters, not your email name or username, not a common passwordPick a longer, less common password
INVALID_QUERY400A query parameter is out of range or not validCheck the parameter

Resource state ​

CodeStatusCauseRecovery
NOT_FOUND404Resource ID doesn't existVerify the ID
SELLER_NOT_FOUND422seller UUID isn't a real userConfirm with support
BUYER_MISMATCH422Link buyer isn't the authenticated userSign the link for the user who will open it
INVALID_STATE409The item cannot take this action in its current state (for example paying an escrow that is already under review)Refresh and check the current status
INVALID_TRANSITION400State machine forbids this action for this roleSee escrow lifecycle
PAYMENT_IN_PROGRESS409Cancel while a payment for the escrow, or for a milestone of an enterprise deal, is still openWait until the payment completes or expires
AWB_IN_USE409The tracking number is on another live escrow between different partiesSend the tracking number of this shipment
AWB_PREDATES_PAYMENT409The courier recorded the tracking number before the escrow was paidSend the tracking number of this shipment
CANCEL_REQUEST_EXISTS409A request to cancel this escrow by agreement is already waiting for an answerWait for the answer, or withdraw your own request
CANCEL_REQUEST_LIMIT409You already asked twice to cancel this escrow by agreementOpen a dispute if there is still a problem
NO_CANCEL_REQUEST, CANCEL_REQUEST_EXPIRED409There is no open cancel request to answer or withdraw, or it lapsed after 48 hoursRead the escrow's cancel_request
OWN_REQUEST403You tried to accept or decline your own cancel requestWait for the other party, or withdraw it

Account verification and limits ​

CodeStatusCauseRecovery
EMAIL_NOT_VERIFIED403The account signed up with email and password and has not confirmed its email. Creating, joining or paying escrows, Jasa Pembayaran orders, withdrawals, creating an enterprise workspace, accepting an invite and every workspace route called with a session or personal key wait for itThe user opens the link in the verification email
EMAIL_DOMAIN_NOT_ALLOWED400Creating an enterprise workspace from an account on a disposable or reserved email domainSign in with an active personal or work email
KYC_REQUIRED403A withdrawal for an account whose KYC is not verified. Nothing is debited. A withdrawal already pending is not affectedThe user completes KYC and withdraws once it is approved
NIK_IN_USE409KYC submit: the NIK already verifies another RekberPay account (an account deleted after its KYC was verified keeps holding it)The user signs in to the account that holds the NIK, or contacts support
NAME_MISMATCH422A withdrawal to a bank account whose holder is not the name on the account's KYC. Nothing is debitedWithdraw to an account in the user's own name, or ask support for a review
CRYPTO_ADDRESS_NOT_ACTIVE403A crypto withdrawal to an address that is not in the user's address book, not confirmed from the email, still in its 24 hour wait, or not an exact match (letter case included)Add and confirm the address, then wait 24 hours
CRYPTO_DAILY_LIMIT400Crypto withdrawals would pass the 24 hour cap (Rp10.000.000 by default). Nothing is debitedA smaller amount, later, or a bank withdrawal
NONKYC_LIMIT_AMOUNT400Account without KYC: the amount is above the per-escrow limitLower the amount or complete KYC
NONKYC_LIMIT_DAILY429Account without KYC: too many escrows in the last 24 hoursTry again later or complete KYC
NONKYC_LIMIT_LIFETIME403Account without KYC: the lifetime total would be passedCancel unpaid escrows that will not go ahead, or complete KYC
NONKYC_LIMIT_COUNTERPARTY403Signed link: the seller cannot take this escrow because of their own limitsThe buyer contacts the seller
NONKYC_LIMIT_SELLER_AT_PAYMENT403Paying a signed-link escrow whose seller has no room leftThe buyer contacts the seller

These refusals also carry a limits object. See Limits for accounts without KYC.

Uploads ​

CodeStatusCauseRecovery
FILE_TOO_LARGE413Over the size limit of the upload typeSend a smaller file
TYPE_NOT_ALLOWED, TYPE_MISMATCH, POLYGLOT400Not an allowed image or PDF, content that does not match its type or extension, or a file hiding another formatSend a real JPEG, PNG, WebP or PDF
IMAGE_TOO_LARGE, IMAGE_DECODE_FAILED400Too many pixels, or a damaged imageSend a smaller or a fresh image
PDF_PASSWORD_PROTECTED400The PDF is locked with a passwordPrint it to a new PDF, or upload a photo of the page
PDF_DAMAGED, PDF_TOO_MANY_PAGES, PDF_UNSUPPORTED_ENCODING, PDF_ACTIVE_CONTENT, PDF_EMBEDDED_FILE400The PDF cannot be opened, is too long, or could not be cleanedSave it again as a PDF with only the pages you need
PDF_TOO_HEAVY400The PDF's pages or images unpack to far more data than a normal documentSave or compress it again, then upload it
PDF_CHECK_UNAVAILABLE503The PDF checker is not available right now. The file itself is fineTry again in a few minutes, or upload a photo of the page
QUOTA_EXCEEDED429The daily upload quota is used upTry again tomorrow
UPLOAD_INVALID_REF, UPLOAD_NOT_FOUND, UPLOAD_NOT_OWNED, UPLOAD_WRONG_PURPOSE400An attached URL is not your own upload of the right typeUpload the file again yourself
UPLOAD_ALREADY_BOUND, UPLOAD_QUOTA409The upload is already attached elsewhere, or the item has all the attachments it may haveUpload a new copy, or attach fewer files

The full list is on Uploads.

Authorization ​

CodeStatusCauseRecovery
FORBIDDEN403Authenticated but not allowedCheck role / ownership
NOT_A_PARTY403Trying to read/post in an escrow you're not a party toBuyer or seller only
NOT_BUYER403A buyer-only action was called by someone elseCall it as the buyer
SUSPENDED403User account is suspendedContact support
ACCOUNT_INACTIVE403The account is closed or being deletedContact support
KEY_NOT_ALLOWED403An API key called a dashboard-only enterprise routeUse a dashboard session
SESSION_REQUIRED403A dashboard action (changing a key's allowed IPs) was called with anything but a dashboard sessionDo it in the dashboard
SCOPE_REQUIRED403A read-only workspace key tried to writeUse a key with the write scope

Rate limiting & body size ​

CodeStatusCauseRecovery
RATE_LIMITED429Too many requests in 1 minuteHonor Retry-After, back off
FST_ERR_CTP_BODY_TOO_LARGE413Request body over 1 MiBTrim the body. Attachments use /v1/upload

Enterprise API ​

CodeStatusCauseRecovery
NO_WORKSPACE403No active workspace, or not a member of the one in X-Enterprise-AccountCheck the workspace ID with GET /v1/enterprise/me
INVALID_ACCOUNT400X-Enterprise-Account is not a UUIDSend the workspace ID
INVALID_MODE400X-Enterprise-Mode (or ?mode= on a GET) is not sandbox or liveSend sandbox or live, or leave it out
LIVE_LOCKED403Live was asked for while the workspace's Live is locked, or a Live key was used while Live is lockedWork in Sandbox until RekberPay approves your business verification
KEY_MODE_MISMATCH403A workspace key sent X-Enterprise-Mode naming the other mode. The key decides the modeRemove the header, or use a key of the mode you want (rpe_test_ or rpe_live_)
CONCURRENT_MODIFICATION409Someone changed the item first, or two writes hit the same deal or counterparty at once and this one was not applied. Nothing was changedRead it again and retry. Safe with the same Idempotency-Key: only 2xx answers are stored
NOT_DRAFT409Only drafts can be edited or activatedCheck the deal status
NOT_AWAITING_APPROVAL409The milestone is not waiting for a decisionRead the milestone
ALREADY_DECIDED409You already decided in this roundAsk another approver
SUBMITTER_CANNOT_APPROVE409The person who delivered the milestone cannot decide on itAsk another approver
NOT_APPROVED409Only an approved milestone can be releasedWait for the approvals
SPLITS_MISMATCH400Release splits do not add up to the milestone payout (the amount minus the counterparty's fee share)Use proposed.payout_amount from GET /v1/enterprise/approvals/:milestoneId
INSTRUCTION_NOT_ELIGIBLE400A payout instruction cannot receive this releaseUse a verified instruction of the deal counterparty
COUNTERPARTY_KYB_REQUIRED409A live release to a counterparty that has not passed business verification. Nothing is queued and the money stays held. Carries counterparty_id, kyb_status and verify_pathSend the counterparty a verification link, and release once RekberPay approves it
PAYOUT_INSTRUCTION_TAMPERED409A payout instruction failed its integrity checkContact RekberPay
BANK_NAME_MISMATCH422A payout instruction's account_holder is not the verified name of the company it pays (the counterparty, or your workspace for a workspace-wide one). At release it must be the deal's counterparty, whichever instruction you pick. Nothing is saved or releasedUse the company's verified legal name. PT, CV, Tbk, case and punctuation are ignored. For a trading name or an abbreviation, contact RekberPay
LIVE_FUNDING_IS_PLATFORM_CONFIRMED409Funding by API only works in SandboxWait for RekberPay to confirm the money
LAST_OWNER409The workspace needs at least one active ownerAdd another owner first
IN_USE409The payout instruction has payoutsLeave it, or add a new one
LOCKED409Evidence of an approved or released milestone cannot be deleted
KEY_LIMIT409The workspace already has 10 active API keys in this mode (the cap is per mode)Revoke one of that mode first
SCOPE_NOT_ALLOWED400Creating a key with a Platform scope your Platform terms do not allow, or while Platform is off in that modeLeave the scope out; GET /v1/enterprise/platform-status lists allowed_scopes
KEY_REVOKED409Changing the allowed IPs of a revoked keyCreate a new key
INVALID_ALLOWED_IPS400Changing a key's allowed IPs: an entry is not an IPv4 or IPv6 address or CIDR range, is a domain name or a /0 range, or the list has more than 20 entries. A live Platform key also needs at least one. On key creation the same problems answer INVALID_BODYFix the list; error.details.fieldErrors.allowed_ips says which entry
IP_ALLOWLIST_REQUIRED403A live Platform key called /v1/enterprise/platform without an IP allowlist approved by RekberPayAdd your server IPs to the key and wait for approval
WORKSPACE_LIMIT409Creating a workspace when you already own the most one account may own (3)Contact RekberPay
TRY_AGAIN409Another workspace sign-up for your account was still runningTry again
TEMPLATE_LIMIT409The workspace already has 50 templatesDelete one first
WEBHOOK_LIMIT409The workspace already has 10 webhooks in this mode (the cap is per mode)Delete one of that mode first
WEBHOOK_PAUSED409The webhook is pausedResume it first
DELIVERY_PENDING409Send again while a delivery of the same event is still being retriedWait for it to finish, then send it again if it failed
WEBHOOK_URL_*400The webhook URL is not allowedUse a public https URL
SIGNING_NOT_CONFIGURED503Payout or webhook signing is not available right nowContact RekberPay
TEST_DEAL409A sandbox deal cannot release real payouts, and a Sandbox request or deal cannot take a live payment (pay, claim-payment)Create the deal in Live, or use the sandbox fund call
LIVE_DEAL_IN_SANDBOX409A live deal cannot be funded with sandbox money or released from Sandbox, and a live milestone funded with sandbox money never releases real payoutsSwitch to Live. If Live is still locked, verify your business first
FEE_NOT_AGREED409The counterparty's workspace has not agreed the fee split, or the link ended and the draft waits for a new one. Raised by activate, and by funding as a safeguardWait for its answer, or accept its counter-offer (fee_agreement on the deal says whose turn it is)
NOTHING_TO_ACCEPT409No split from the other workspace is waiting for youRead fee_agreement.proposed_by
ALREADY_AGREED409The split is already agreed, so it cannot be counteredAsk the payer to change the draft
NO_FEE409The deal was made before platform fees and has no split to counterNothing to do
INVALID_FEE_ALLOCATION400split without fee_buyer_percent, or buyer or seller with a percent that disagreesUse buyer, seller, or split with a percent from 0 to 100
COUNTERPARTY_REQUIRED409Activating a deal that has no counterpartySet counterparty_id first
COUNTERPARTY_NOT_FOUND404The counterparty is not in this workspaceCheck the ID
COUNTERPARTY_UNLINKED409The counterparty was unlinked from its workspace and takes no new deal until it is linked againSend a new link request and wait for its acceptance, or use it as a regular counterparty
NOT_ON_HOLD409use-as-regular on a counterparty that is not waiting for a new linkIt already takes new deals
DUPLICATE_COUNTERPARTY409Adding a counterparty whose company name matches one you already have. existing lists the matchesUse the existing one, or send allow_duplicate: true
RESEND_TOO_SOON429An invite was already sent in the last 10 minutes. For a deal preview link or a link invitation: the last email went out less than an hour agoWait for Retry-After seconds, then resend
EMAIL_NOT_SENT502An invite resend could not be sentResend again in a minute
WORKSPACE_NOT_FOUND404No workspace has the Workspace ID in a link requestAsk the other company to copy its ID from GET /v1/enterprise/me or Settings
SAME_WORKSPACE400A link request names your own workspaceUse the other workspace's ID
ALREADY_LINKED409The counterparty is already linked to a workspaceUnlink it first
NOT_LINKED409The counterparty has no link and no open request, or the link is no longer acceptedRead the link with GET /v1/enterprise/counterparty-links
COUNTERPARTY_LIVE_LOCKED409A live deal (create, update or activate) names a counterparty linked to a workspace whose Live is still locked.Create the deal in Sandbox, or ask the partner to verify its business
LINK_HAS_LIVE_DEALS409From Sandbox: ending a link that serves Live, or using a counterparty as a regular one, while the paying workspace has live deals with that partnerSwitch to Live and do it there
COUNTERPARTY_HAS_LIVE_DEALS409From Sandbox: changing the name or country of a counterparty that has live dealsSwitch to Live and change it there
COUNTERPARTY_LIVE_VERIFIED409From Sandbox while Live is unlocked: changing the name or country of a counterparty that is verified or has a payout override, which Live relies on (it may have no live deals yet)Switch to Live and change it there
LIVE_SETTING_SANDBOX409From Sandbox while Live is unlocked, or while Live is locked again with live deals on file: changing a setting or the default fee split that also applies to LiveSwitch to Live and change it there (after a relock: once Live opens again)
DEAL_ARCHIVED409A shared deal is completed or cancelled and is a read-only recordNothing to do
SANDBOX_WORKSPACE409A Sandbox request tried to answer a split, deliver on or dispute a live shared dealSwitch to Live. If Live is still locked, verify your business first
NO_MANUAL_PAYMENT409claim-payment on a milestone whose newest payment is not a pending manual transferStart one with pay, using a manual method
TOO_MANY_PAYMENT_LINKS429A milestone already has 5 open attempts on automatic gatewaysUse one of them or wait for it to expire
INVALID_CHANNEL400Paying a milestone or a whole deal (pay): channel is not a bank or store the chosen method offers, or a store payment (cstore) has no channel. Consumer payments answer the samePick a channel from the methods list, or leave it out where none is needed
AMOUNT_OUT_OF_RANGE400pay: the total, fee included, is outside what the chosen method accepts. The message gives the rangeChoose another method
GATEWAY_MISCONFIGURED503pay: the chosen method is not available right now. Nothing was charged or reservedChoose another method, or retry later
PAYEE_DELIVERS409Delivering a milestone (submit-evidence) on a deal shared with the counterparty's workspace. The counterparty delivers it from its own sideAsk the counterparty to deliver from its shared deal
DEAL_CREATE_BUSY409Another deal of the workspace is being created at the same momentRetry
NOT_CANCELLABLE409Nothing on the deal is left to cancel: every milestone is released, disputed or already cancelled (a disputed milestone stays with its dispute). Also answered when no money is held but a milestone is released next to unfunded ones, with the message "A milestone is already funded. Open a dispute instead."Wait for the dispute to be decided
NO_MILESTONES409Activating a deal with no milestoneAdd one first
INVALID_DOCUMENTS400A document of the evidence or dispute is not in this workspace, deal or milestone. From Sandbox while Live is unlocked or has live deals, also a document on no deal (it is shared with Live)Register the document first; from Sandbox, upload it to the deal
NOT_DISPUTED409dispute-evidence on a milestone whose dispute is not openAdd evidence while the dispute is open
APPLICATION_LOCKED409KYB: the application is submitted and waiting for review, so it cannot changeWait for the decision
ALREADY_VERIFIED409KYB: the workspace or counterparty is already verifiedNothing to do
INCOMPLETE422KYB: submitting while a step is not complete. error.details lists what is missingFinish the missing steps and documents
SUSPENDED409KYB: a suspended business tried to submitContact RekberPay
DOCUMENT_LIMIT409KYB: the application already has 40 documentsRemove one first
PERSON_NOT_FOUND404KYB: person_id is not on this applicationUse a person id from application.people
INVITE_INVALID404A KYB verification link is malformed, revoked or replacedAsk for a new link
INVITE_EXPIRED410A KYB verification link is older than 14 daysAsk for a new link
INVITE_CLAIMED403Another RekberPay account already opened this KYB verification linkAsk for a new link
INVITE_OTHER_EMAIL403A KYB verification link was emailed to another addressSign in with that verified address, or ask for a new link
SAME_FILE409KYB: the file is the one the reviewer asked you to replace (on attach, or on submit with doc_type)Upload a corrected or newer copy
NOTHING_CHANGED422KYB: submitting a rejected application again with nothing changedChange what the reviewer asked for, then submit
KYB_UNAVAILABLE503Business verification is not available right nowRetry later
KYB_SEAL_ERROR500A protected KYB value could not be readContact RekberPay
PAYMENT_IN_PROGRESS409A live payment can still land on the deal, so it cannot be cancelled yet, and a cancellation cannot be proposedWait until RekberPay confirms the payment or it expires
FUND_WHOLE_DEAL409The deal is funded upfront and is not funded yet, so a milestone cannot be paid or funded alonePOST /v1/enterprise/deals/:id/pay (or /fund in Sandbox) for the whole deal
NOT_UPFRONT409A whole-deal payment call on a deal that is paid per milestonePay or fund each milestone
FUNDING_MODE_LOCKED409funding_mode was changed on a deal that is no longer a draftSet the mode before activation
CANCEL_ALREADY_PROPOSED409A cancellation proposal is already waiting for the counterparty to answerWait, or withdraw it with DELETE /v1/enterprise/deals/:id/cancel-request
CANCEL_NOT_PROPOSED409There is no open cancellation proposal (none was made, it was withdrawn, answered or ran out its 7 days)Read the deal's cancel_request
KYB_REQUIRED403The counterparty workspace acted on a live deal before its business verification was approved. Reads and test deals are never refusedVerify the business, then retry
PAYEE_CHOSE_PAYOUT409Release with splits on a deal where the counterparty chose its payout accountRelease with no splits
PAYER_ONLY403The counterparty side tried to add or remove a required documentAsk the paying workspace
REQUIREMENT_MISMATCH400An upload does not match the document requirement it namesUpload a shared file of the required type, on the same milestone when the requirement names one
REQUIREMENT_MET409Removing a document requirement that already has its documentLeave it
FILE_NOT_OWNED400A room or milestone file is a link, was not uploaded by your workspace, or is already filed somewhere elseUpload it from your workspace first
FILED_BY_COUNTERPARTY403Deleting a room file the other workspace filedOnly that workspace can delete it
EVIDENCE_LOCKED409Deleting a file on a milestone whose delivery is under review, in dispute or approvedLeave it
LEAD_NOT_ELIGIBLE400The deal lead is not an active member of your workspace who can work on dealsPick another member
PREVIEW_NOT_ALLOWED409A preview link action the deal does not allow: a test deal never emails an outside address, Live is not unlocked, the deal is cancelled, the counterparty has a workspace, or there is no contact emailCopy the link instead, or add a contact email
PREVIEW_OFF409The preview link is turned off. A reset only works after you turned it off yourself; a cancelled deal, a workspace link or a turn off by RekberPay cannot be resetReset it if you turned it off, otherwise nothing to do
DEAL_NOT_ACTIVE409A draft deal tried to send or copy a preview link, or to be funded or paidActivate the deal first
RESEND_LIMIT_REACHED429A preview link was already emailed 5 times for the deal, or a counterparty was already invited 5 timesCopy the link instead
MAIL_LIMIT_REACHED429RekberPay already sent this contact as many emails as it allows in a dayWait for Retry-After seconds
MAIL_FAILED502The preview link email could not be sentCopy the link instead
INVITES_PAUSED503Invitations by email are paused right now. The send is given backTry again later
NO_CONTACT409The counterparty has no contact emailAdd one first
LINK_EXPIRED410A preview link expired, was reset or turned off, or a claim link was already used (answered to the person who opened it in the browser)Ask the sender for a new link
CLAIM_SELF403The person who claims a deal from the preview is a member of the workspace that sent itUse another account
EMAIL_NOT_VERIFIED403Claiming a deal with an email that is not verifiedVerify the email first

Platform mode ​

The partner API under /v1/enterprise/platform has its own codes, such as USER_NOT_AVAILABLE, REF_IN_USE, NAME_LOCKED, NAME_MISMATCH, DAILY_CAP_REACHED, BANK_ACCOUNT_COOLING_OFF, and for chat, tracking and uploads MESSAGE_INVALID, MESSAGE_RATE_LIMITED, ATTACHMENT_INVALID, ATTACHMENT_NOT_FOUND, DEAL_CLOSED_FOR_CHAT, TRACKING_NOT_FOUND and TRACKING_UNAVAILABLE, on the buyer page WEB_SESSION_REQUIRED and NOT_BUYER, on the secure deal link BALANCE_PAYMENT_DISABLED and ORDER_CHANGED, at ship AWB_IN_USE and AWB_PREDATES_PAYMENT, and for account deletion DELETION_BLOCKED, DELETION_NOT_CANCELLABLE and DELETION_NOT_REQUESTED. Every one is listed in the Platform error codes.

Server-side ​

CodeStatusCauseRecovery
INTERNAL_ERROR500Unhandled server errorRetry with same idempotency key
GATEWAY_ERROR502The payment gateway rejected or failed the charge requestRetry; if it persists, pick another method
UNIQUE_CODE_BUSY503pay with manual bank transfer found no free unique code for that total. Nothing was chargedRetry in a moment, or pick another method
VALIDATION_FAILED400Request failed schema validation at the framework layerCheck body and params against the endpoint

Jasa Pembayaran ​

CodeStatusCauseRecovery
FEATURE_DISABLED503Jasa Pembayaran is switched offRetry later; check GET /v1/jasabayar/config
AMOUNT_TOO_LARGE400item_price above max_item_price_idrLower the amount or split the order
ALREADY_PAID409Cancel on an order that is no longer awaiting_paymentContact support if it is funded
DECRYPT_FAILED500The order's saved details could not be readContact support with the order ID
DB_ERROR500Order was not created; no funds were takenSafe to retry

Reading error responses ​

Every error response is JSON. Treat anything else as a network/proxy issue, not a RekberPay error.

js
const res = await fetch(url, options);
if (!res.ok) {
    const ct = res.headers.get('content-type') ?? '';
    if (!ct.includes('application/json')) {
        throw new Error(`Network error: ${res.status} ${res.statusText}`);
    }
    const { error } = await res.json();
    throw new ApiError(error.code, error.message, res.status);
}

Recovery patterns ​

Idempotent retry on 5xx / network failure ​

js
async function withRetry(fn, max = 5) {
    let attempt = 0;
    while (attempt < max) {
        try {
            return await fn();
        } catch (err) {
            if (err.status && err.status < 500) throw err; // 4xx, don't retry
            if (attempt === max - 1) throw err;
            await sleep(1000 * Math.pow(2, attempt++));
        }
    }
}

Backoff on 429 ​

The response includes a Retry-After header (seconds):

js
if (res.status === 429) {
    const wait = Number(res.headers.get('Retry-After') ?? 60);
    await sleep(wait * 1000);
    return retry();
}

Refresh on INVALID_STATE ​

js
if (err.code === 'INVALID_STATE') {
    // Fetch the latest state and decide what to do
    const { data } = await fetch(`/v1/escrows/${id}/payment-status`).then(r => r.json());
    if (data.status === 'paid') {
        // Already paid, treat as success
        return;
    }
    throw err;
}

Reporting bugs ​

If you hit a 500 you can't explain, email [email protected] with:

  • escrow_id (or other resource ID)
  • Approximate timestamp (UTC)
  • Request body (redact secrets)
  • Response body

Include the requestId when the error has one.

See also ​

Escrow, payment services and B2B deals for Indonesian businesses.