MostRecentTransactions
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
string, 10 characters, required
The Paymentology issued terminal ID of the terminal requesting the transaction
string, 1-255 characters, required
Customer reference linked with this card
string, 1-20 characters, required
The tracking number of the card to retrieve the transactions for
string, 1-255 characters, required
The UUID of the pocket to retrieve the transactions for
string, 1-255 characters, required
Transaction ID number generated by the calling client
date, required
Starting date of the date range you wish to pull the transactions for. End date will be today’s date.
integer, required
The number of transaction(s) that need to be returned
string, required
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
STATUS200 OK
Schema
string
Echo of incoming value transactionID
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”
string
Status code indicating transaction result
string
Echo
string
Echo
string
Text indicating transaction result
string
Echo
string
Transaction id generated by Paymentology
string
Echo
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>