# Transaction History Detail

## **Method and URL**

`POST` \[BASE\_URL]/wallet-backend/snap/v1.0/transaction-history-detail

Purpose:  Retrieve detailed information for a specific transaction using the partner’s reference number.<br>

Authorization:

* B2B Token&#x20;
* B2B2C Token

## **Request**

**Request Header**

<table><thead><tr><th>Header</th><th width="138.6240234375">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": "REF/20250723/0001",
  "additionalInfo": {}
}
```

**Request Parameter Detail**&#x20;

<table><thead><tr><th>Parameter</th><th width="105.8896484375">Data Type</th><th width="114.9462890625">Character Limit</th><th width="125.5126953125">Requirement</th><th>Description</th></tr></thead><tbody><tr><td>originalPartnerReferenceNo</td><td>String</td><td>64</td><td>Mandatory</td><td>Partner’s reference number for the transaction whose details are being requested.</td></tr><tr><td>additionalInfo</td><td>Object</td><td>-</td><td>Optional</td><td>Reserved for future extensions (empty object {} in the example).</td></tr></tbody></table>

## **Response**

**Response Body**

```json
{
  "amount": {
    "currency": "IDR",
    "value": "79150.00"
  },
  "dateTime": "2025-07-23T05:54:17+07:00",
  "partnerReferenceNo": "REF/20250723/0001",
  "referenceNo": "019835d8-cacc-7790-ab78-15b25bb89d12",
  "responseCode": "2001300",
  "responseMessage": "Successful",
  "status": "SUCCESS",
  "type": "TOP_UP"
}
```

**Response Parameter Detail**

<table><thead><tr><th>Parameter</th><th width="114.21484375">Data Type</th><th width="125.9736328125">Character Limit</th><th width="129.3369140625">Requirement</th><th>Description</th></tr></thead><tbody><tr><td>amount</td><td>Object</td><td>-</td><td>Mandatory</td><td>Transaction amount details.</td></tr><tr><td>amount.currency</td><td>String</td><td>3</td><td>Mandatory</td><td>Currency code, e.g., IDR.</td></tr><tr><td>amount.value</td><td>String</td><td>20</td><td>Mandatory</td><td>Transaction amount in decimal string format.</td></tr><tr><td>dateTime</td><td>String (ISO 8601)</td><td>30</td><td>Mandatory</td><td>Date and time when the transaction occurred.</td></tr><tr><td>partnerReferenceNo</td><td>String</td><td>64</td><td>Mandatory</td><td>Partner’s original reference number associated with the transaction.</td></tr><tr><td>referenceNo</td><td>String</td><td>64</td><td>Mandatory</td><td>Internal system reference number for the transaction.</td></tr><tr><td>responseCode</td><td>String</td><td>7</td><td>Mandatory</td><td>Response status code. 2001300 indicates successful detail retrieval.</td></tr><tr><td>responseMessage</td><td>String</td><td>100</td><td>Mandatory</td><td>Description of the request result (e.g., Successful).</td></tr><tr><td>status</td><td>String</td><td>20</td><td>Mandatory</td><td>Transaction status, e.g. SUCCESS.</td></tr><tr><td>type</td><td>String</td><td>20</td><td>Mandatory</td><td>Transaction type, e.g. TOP_UP.</td></tr></tbody></table>

\ <br>