# 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.<br>

Authorization:

* B2B Token&#x20;
* B2B2C Token

## **Request**

**Request Header**

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

**Request Body**

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

**Request Parameter Detail**&#x20;

<table><thead><tr><th>Parameter</th><th width="106.2705078125">Data Type</th><th width="108.4912109375">Character Limit</th><th width="122.9130859375">Requirement</th><th>Description</th></tr></thead><tbody><tr><td>originalPartnerReferenceNo</td><td>String</td><td>64</td><td>Mandatory</td><td>The partner’s original reference number for the payment request being checked.</td></tr><tr><td>serviceCode</td><td>String</td><td>5</td><td>Mandatory</td><td>SNAP service code for debit payment status inquiry (54).</td></tr></tbody></table>

## **Response**

**Response Body**

```json
{
  "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**

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

\ <br>