Transaction History List

Method and URL

POST [BASE_URL]/wallet-backend/snap/v1.0/transaction-history-list

Purpose: Retrieve a paginated list of the customer’s wallet transaction history within a specified date and time range.

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

{
  "partnerReferenceNo": "",
  "fromDateTime": "2025-07-22T00:00:00+07:00",
  "toDateTime": "2025-07-23T12:08:56+07:00",
  "pageSize": "10",
  "pageNumber": "1",
  "additionalInfo": {}
}

Request Parameter Detail

Parameter	Data Type	Character Limit	Requirement	Description
partnerReferenceNo	String	64	Optional	Partner’s reference number to filter a specific transaction. Empty string ("") means no filter by reference.
fromDateTime	String (ISO 8601)	30	Mandatory	Start date-time (inclusive) of the transaction search range, with timezone offset.
toDateTime	String (ISO 8601)	30	Mandatory	End date-time (inclusive) of the transaction search range, with timezone offset.
pageSize	String	3	Mandatory	Number of records per page (e.g., "10").
pageNumber	String	5	Mandatory	Page number to retrieve, starting from "1".
additionalInfo	Object	-	Optional	Reserved for future/extra filtering parameters. Empty object {} in the example.

Response

Response Body

{
  "detailData": [
    {
      "dateTime": "2025-07-23T05:54:17+07:00",
      "status": "SUCCESS",
      "type": "TOP_UP",
      "amount": {
        "value": "79150.00",
        "currency": "IDR"
      },
      "additionalInfo": {
        "referenceNo": "019835d8-cacc-7790-ab78-15b25bb89d12",
        "partnerReferenceNo": "REF/20250723/0001"
      }
    },
    {
      "dateTime": "2025-07-22T03:30:19+07:00",
      "status": "SUCCESS",
      "type": "TOP_UP",
      "amount": {
        "value": "799150.00",
        "currency": "IDR"
      },
      "additionalInfo": {
        "referenceNo": "0198302e-a058-7e78-82f2-9d009208bdf7",
        "partnerReferenceNo": "REF/20250523/0012"
      }
    }
  ],
  "responseCode": "2001200",
  "responseMessage": "Successful"
}

Response Parameter Detail

Parameter	Data Type	Character Limit	Requirement	Description
detailData	Array	-	Mandatory	List of transaction records returned for the requested page.
detailData[].dateTime	String (ISO 8601)	30	Mandatory	Date and time of the transaction with timezone offset.
detailData[].status	String	20	Mandatory	Transaction status, e.g., SUCCESS.
detailData[].type	String	20	Mandatory	Transaction type, e.g., TOP_UP, PAYMENT, etc.
detailData[].amount	Object	-	Mandatory	Amount information of the transaction.
detailData[].amount.value	String	20	Mandatory	Transaction amount in decimal string format.
detailData[].amount.currency	String	3	Mandatory	Currency code, e.g., IDR.
detailData[].additionalInfo	Object	-	Optional	Additional information related to the transaction.
detailData[].additionalInfo.referenceNo	String	64	Mandatory	Internal system reference number for the transaction.
detailData[].additionalInfo.partnerReferenceNo	String	64	Optional	Partner’s reference number associated with the transaction.
responseCode	String	7	Mandatory	Response status code. 2001200 indicates successful retrieval.
responseMessage	String	100	Mandatory	Description of the result, e.g., Successful.