MostRecentTransactions provides the latest transactions on the basis of following two criteria:
- Date Range (start Date and End Date)
- Transaction Count (The number of transaction that needs to be returned in the api call)
Request Path Parameters
| Parameter | type | Limits | required | Description |
|---|---|---|---|---|
| terminalID | String | 10 characters | ✓ | The Paymentology issued terminal id of the terminal requesting the transaction |
| customerReference | String | 1-255 characters | ✓ | Customer reference linked with this card |
| trackingNumber | String | 1-20 characters | ✓ | The tracking number of the card to retrieve the transactions for |
| pocketUUID | String | 1-255 characters | ✓ | The UUID of the pocket to retrieve the transactions for |
| transactionID | String | 1-255 characters | ✓ | A unique identifier generated by the client, which must not be duplicated over time. |
| transactionDate | Date | ✓ | Starting date of the date range you wish to pull the transactions for. End date will be today’s date. | |
| numTransactions | Integer | ✓ | The number of transaction(s) that need to be returned | |
| checksum | String | ✓ | HMAC-SHA256 hashed signature of the concatenated method name with all argument values using the terminal password as private key |
<?xml version="1.0" encoding="UTF-8"?>
<methodCall>
<methodName>MostRecentTransactions</methodName>
<params>
<param>
<value>
<string>{{terminalID}}</string>
</value>
</param>
<param>
<value>
<string>{{customerReference}}</string>
</value>
</param>
<param>
<value>
<string>{{trackingNumber}}</string>
</value>
</param>
<param>
<value>
<string>pocketUUID</string>
</value>
</param>
<param>
<value>
<string>{{transactionID}}</string>
</value>
</param>
<param>
<value>
<dateTime.iso8601>{{transactionDate}}</dateTime.iso8601>
</value>
</param>
<param>
<value>
<int>numTransactions</int>
</value>
</param>
<param>
<value>
<string>{{checksum}}</string>
</value>
</param>
</params>
</methodCall>
Response Parameters
| Field | type | Description |
|---|---|---|
| clientTransactionID | String | Echo of incoming value transactionID |
| statement | Array | The transaction history of the card transactionType, string The identifier depicting the type of transaction. 1 – Load 2 – Deduction 3 – Authorization transactionDate, date Date and time of the transaction, string in ISO 8601 format eg. “20150121T02:04:35” transactionAmount, double Transaction amount transactionDescription, string Transaction description systemDate, date Paymentology’s system date in UTC +7 time zone, string in ISO 8601 format eg. “20150121T02:04:35” |
| resultCode | String | Status code indicating transaction result |
| terminalID | String | Echo |
| customerReference | String | Echo |
| resultText | String | Text indicating transaction result |
| pocketUUID | String | Echo |
| serverTransactionID | String | Transaction id generated by Paymentology |
| trackingNumber | String | Echo |
| balance | Array | Array includes: **currency;****amount;**pocketUUID |
<?xml version="1.0" encoding="UTF-8"?>
<methodResponse>
<params>
<param>
<value>
<struct>
<member>
<name>clientTransactionID</name>
<value>
<string>887766554</string>
</value>
</member>
<member>
<name>statement</name>
<value>
<array>
<data>
<value>
<struct>
<member>
<name>transactionType</name>
<value>
<int>1</int>
</value>
</member>
<member>
<name>transactionDate</name>
<value>
<dateTime.iso8601>20220912T17:21:03</dateTime.iso8601>
</value>
</member>
<member>
<name>transactionAmount</name>
<value>
<int>10000</int>
</value>
</member>
<member>
<name>transactionDescription</name>
<value>
<string>name Of Card Issuer</string>
</value>
</member>
<member>
<name>systemDate</name>
<value>
<dateTime.iso8601>20220912T17:21:03</dateTime.iso8601>
</value>
</member>
</struct>
</value>
</data>
</array>
</value>
</member>
<member>
<name>resultCode</name>
<value>
<int>1</int>
</value>
</member>
<member>
<name>terminalID</name>
<value>
<string>1234567891</string>
</value>
</member>
<member>
<name>customerReference</name>
<value>
<string>123876543054</string>
</value>
</member>
<member>
<name>resultText</name>
<value>
<string>Approved</string>
</value>
</member>
<member>
<name>pocketUUID</name>
<value>
<string>1ABCD123-DB9B-12C5-AB1CE2FD2B12345F</string>
</value>
</member>
<member>
<name>serverTransactionID</name>
<value>
<string>12FUHJ8I-S23D-1QW2-D43401123456789J</string>
</value>
</member>
<member>
<name>trackingNumber</name>
<value>
<string>123451234567899</string>
</value>
</member>
<member>
<name>balance</name>
<value>
<array>
<data>
<value>
<struct>
<member>
<name>currency</name>
<value>
<string>976</string>
</value>
</member>
<member>
<name>amount</name>
<value>
<int>10000</int>
</value>
</member>
<member>
<name>pocketUUID</name>
<value>
<string>1ABCD123-DB9B-12C5-AB1CE2FD2B12345F</string>
</value>
</member>
</struct>
</value>
</data>
</array>
</value>
</member>
</struct>
</value>
</param>
</params>
</methodResponse>