Skip to main content
POST
/
api
/
v2.0
/
disbursement
/
{account_id}
/
inquiry-status
Inquiry Status
curl --request POST \
  --url https://sandbox-payment-b2b.singapay.id/api/v2.0/disbursement/{account_id}/inquiry-status \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-PARTNER-ID: <api-key>' \
  --data '
{
  "reference_number": "1134567891011"
}
'
{
  "response_code": "SP000",
  "response_message": "Successfully",
  "data": {
    "transaction_id": "331222025121209092460774035",
    "reference_number": "1134567891011",
    "transaction_status": {
      "code": "03",
      "desc": "Pending"
    },
    "post_timestamp": "1765505364000",
    "processed_timestamp": "",
    "bank": {
      "code": "002",
      "name": "BRI",
      "account_name": "Cengkal Marpaung",
      "account_number": "1234567890000"
    },
    "gross_amount": {
      "currency": "IDR",
      "value": "51000.00"
    },
    "fee": {
      "currency": "IDR",
      "value": "1000.00"
    },
    "net_amount": {
      "currency": "IDR",
      "value": "50000.00"
    },
    "balance_after": {
      "currency": "IDR",
      "value": "1000000.00"
    },
    "notes": "sometimes"
  }
}

Authorizations

Authorization
string
header
required

JWT issued by POST /api/v1.1/access-token/b2b. Send Authorization: Bearer <token>.

X-PARTNER-ID
string
header
required

Merchant API key (Credential.api_key). Required on every request.

Path Parameters

account_id
string
required

Unique identifier (ULID) of the merchant account that owns the disbursement. Must belong to the authenticated merchant.

Body

application/json

Request body for looking up a disbursement by merchant reference number.

reference_number
string
required

Merchant reference supplied when the transfer was created. Lookup is scoped to the account in the path and the authenticated merchant.

Maximum string length: 64
Example:

"1134567891011"

Response

SP000 Successfully. Merchant action: interpret data.transaction_status (03 Pending, 00 Success, 06 Failed).

Custom v2 envelope for disbursement inquiry status. Success uses SP000 (HTTP 200).

response_code
string
required

SingaPay custom business response code.

Example:

"SP000"

response_message
string
required

Human-readable label paired with response_code.

Example:

"Successfully"

data
object
required

data on successful disbursement v2 transfer or v2 inquiry status (HTTP 200, response_code SP000).