History List

This is one of the services providing user e-money transaction history in list format, where partners are able to query the date range for transaction history information. Response may vary depending on the transaction history owned by the user, where partners need to maintain its UI and UX in paginating.

Technical Specification

Service Code: 12

Environment	Method	URL
Development	POST	https://snapstag.finnet.co.id/v1.0/transaction-history-list
Production	POST	https://snap.finnet.co.id/v1.0/transaction-history-list

Body Request

No	Name	Type	Mandatory	Min Length	Max Length	Description
1	fromDateTime	String	M	1	25	Starting time range. Default: NOW (DESC) or NOW - 3 months (ASC)
2	toDateTime	String	M	1	25	Ending time range. Default: NOW - 3 months (DESC) or NOW (ASC)
3	pageSize	Integer	M	1	2	Maximum number of transactions returned in one pagination. Default: 10
4	pageNumber	Integer	M	1	2	Current page number. Default: 0
5	type	String	O	1	6	Transaction type. Fill with TRX or Top up
6	sort	String	0	1	3	Sorting type by datetime. Fill with ASC or DESC

Sample Request

{
  "fromDateTime": "2019-07-03T12:08:56+07:00",
  "toDateTime": "2019-07-03T12:08:56+07:00",
  "pageSize": 10,
  "pageNumber": 2,
  "sort":"ASC",
  "type":"TRX"
}

Body Response

No	Name	Type	Mandatory	Min Length	Max Length	Description
1	responseCode	Enum	M	1	7	BI SNAP Response Code.
2	responseMessage	String	M	1	150	BI SNAP Response Message.
3	detailData	Object	O	1	7	Datail Data

Sample Response

{
  "responseCode": "2001200",
  "responseMessage": "Request has been processed successfully",
  "detailData": [
    {
      "dateTime": "2022-12-02T08:18:13+00:00",
      "amount": {
        "value": "10000.00",
        "currency": "IDR"
      },
    "remark": "Pulsa Rp. 10000",
    "status": "SUCCESS",
    "type": "TEST",
    "additionalInfo": {
        "partnerReferenceNo": "78912343452347003",
        "referenceNo": "2212020005597959",
        "trxcode": "WS_TRX_TRANSFER",
        "id": "16109172",
        "sum_in": "0",
        "sum_out": "10000",
        "channel_id": "140",
        "source": "[phone]",
        "destination": "[phone]",
        "name": "Testing"
      }
    },
    {
    "dateTime": "2022-12-02T13:15:18+00:00",
    "amount": {
        "value": "1000.00",
        "currency": "IDR"
      },
    "remark": "pulsa 1000",
    "status": "SUCCESS",
    "type": "TEST",
    "additionalInfo": {
        "partnerReferenceNo": "7891234345230001",
        "referenceNo": "2212020005599921",
        "trxcode": "WS_TRX_TRANSFER",
        "id": "16109272",
        "sum_in": "0",
        "sum_out": "1000",
        "channel_id": "140",
        "source": "[phone]",
        "destination": "[phone]",
        "name": "Testing"
      }
    }
  ]
}

Response Code & Message

The table below lists response codes and messages for the History List API.

No	HTTP Code	Code	Message (Indonesian)
1	200	2001200	Successful
2	400	4001200	Bad request
3	400	4001201	Invalid field format {field}
4	400	4001202	Invalid mandatory field {field}
5	401	4011201	Invalid token (B2B)
6	401	4011200	Unauthorised. [Reason]
7	403	4031201	Feature not allowed
8	403	4031204	Activity count limit exceeded
9	404	4041208	Invalid merchant
10	500	5001200	General error