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.

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": "REF/20250723/0001",
  "additionalInfo": {}
}

Request Parameter Detail

Parameter	Data Type	Character Limit	Requirement	Description
originalPartnerReferenceNo	String	64	Mandatory	Partner’s reference number for the transaction whose details are being requested.
additionalInfo	Object	-	Optional	Reserved for future extensions (empty object {} in the example).

Response

Response Body

{
  "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

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