Inquiry Payment Status

Method and URL

POST [BASE_URL]/wallet-backend/snap/v1.0/debit/status

Purpose: Initiate a debit/payment transaction using the customer’s Pivot Pay balance via host-to-host integration. The API returns a web redirect URL for the payment authorization page.

Authorization:

• B2B Token

• B2B2C Token

Request

Request Header

Header	Requirement	Description
Content-Type	Mandatory	application/json
Authorization	Mandatory	Bearer {B2B_access_token}
Authorization-Customer	Mandatory	Bearer {B2B2C_access_token}
X-SIGNATURE	Mandatory	HMAC signature generated as per SNAP specification HMAC_SHA512 (clientSecret, stringToSign) stringToSign = HTTPMethod +”:“+ EndpointUrl +":"+ AccessToken +":“+ Lowercase(HexEncode(SHA-256(minify(RequestBody))))+ ":“ + TimeStamp
X-TIMESTAMP	Mandatory	Request timestamp in yyyy-MM-dd'T'HH:mm:ssXXX (ISO 8601 with offset)
X-PARTNER-ID	Mandatory	Partner ID assigned by Pivot
X-EXTERNAL-ID	Mandatory	Unique ID per request for idempotency / tracing
CHANNEL-ID	Mandatory	Channel identifier (e.g., 12345)

Request Body

{
  "originalPartnerReferenceNo": "partner-ref-9",
  "serviceCode": "54"
}

Request Parameter Detail

Parameter	Data Type	Character Limit	Requirement	Description
originalPartnerReferenceNo	String	64	Mandatory	The partner’s original reference number for the payment request being checked.
serviceCode	String	5	Mandatory	SNAP service code for debit payment status inquiry (54).

Response

Response Body

{
  "feeAmount": {
    "currency": "IDR",
    "value": "0.00"
  },
  "latestTransactionStatus": "05",
  "originalPartnerReferenceCode": "partner-ref-9",
  "paidTime": "2025-05-23T03:35:41+07:00",
  "responseCode": "2005500",
  "responseMessage": "Successful",
  "serviceCode": "54",
  "transAmount": {
    "currency": "IDR",
    "value": "1245.00"
  },
  "transactionStatusDesc": "Cancelled"
}

Response Parameter Detail

Parameter	Data Type	Character Limit	Requirement	Description
feeAmount	Object	-	Mandatory	Fee charged for the transaction.
feeAmount.currency	String	3	Mandatory	Currency code, e.g., IDR.
feeAmount.value	String	20	Mandatory	Fee amount in decimal string.
latestTransactionStatus	String	5	Mandatory	Latest status code of the transaction. Example: 05.
originalPartnerReferenceCode	String	64	Mandatory	Partner’s original reference number (same as request).
paidTime	String (ISO 8601)	30	Optional	Time the transaction was completed (if applicable).
responseCode	String	7	Mandatory	Response code. 2005500 indicates success.
responseMessage	String	100	Mandatory	Description of the result, e.g., Successful.
serviceCode	String	5	Mandatory	Service code (54).
transAmount	Object	-	Mandatory	Transaction amount details.
transAmount.currency	String	3	Mandatory	Currency of the original debit transaction.
transAmount.value	String	20	Mandatory	Transaction amount in decimal string.
transactionStatusDesc	String	20	Mandatory	Description of the latest status