Receiving Institution
Available Methods
- CreateQRData – The method returns a QR including the received information and a new card number linked to the input reference with every request.
- DeactiveateQR – Deactivate a card.
Request
Path parameters
string, 10 characters, required
The Paymentology issued terminal ID of the terminal requesting the transaction
string, 1-4 characters, required
Mastercard defined merchant category code
string, 40 characters, required
Business name of the merchant
string, 25 characters, required
City of the merchant
string, 3 characters, required
ISO alpha country code of the recipient/merchant Ex. ZAF
string, 1-255 characters, required
The user defined reference to the card; for example a member id or wallet number
string, 1-40 characters, required
Transaction ID number generated by the calling client
date
Client generated / local transaction date to assist in identifying transactions on the client side
string
Struct with optional fields, right now only “postalCode” field is accepted. See above for details. The maximum length of the postalCode is 10.
string, required
HMAC-SHA1 hashed signature of the concatenated method name with all argument values using the terminal password as private key
<methodCall>
<methodName>CreateQRData</methodName>
<params>
<param>
<value>
<string>0012546711</string>
</value>
</param>
<param>
<value>
<string>5111</string>
</value>
</param>
<param>
<value>
<string>Main choc Supplies</string>
</value>
</param>
<param>
<value>
<string>Bangkok</string>
</value>
</param>
<param>
<value>
<string>THA</string>
</value>
</param>
<param>
<value>
<string>tst-ref-01</string>
</value>
</param>
<param>
<value>
<string>tst-txid-01</string>
</value>
</param>
<param>
<value>
<dateTime.iso8601>20180307T13:01:30+0000</dateTime.iso8601>
</value>
</param>
<param>
<value>
<struct/>
</value>
</param>
<param>
<value>
<string>D11B110F10EF0328FAB11113EC1F94402415C991</string>
</value>
</param>
</params>
</methodCall>
Response
STATUS200 OK
Schema
integer
Status code indicating transaction result
string
Text indicating transaction result
string
QR code generated for the merchant
string
Base64 string of QR code image generated for the merchant
string
The first 15 digits of the card number
<methodResponse>
<params>
<param>
<value>
<struct>
<member>
<name>resultCode</name>
<value>
<double>1</double>
</value>
</member>
<member>
<name>cardNumber</name>
<value>
<double>1234563265844581</double>
</value>
</member>
<member>
<name>resultText</name>
<value>
<string>Approved</string>
</value>
</member>
<member>
<name>qrCodeImage</name>
<value>
<string>[BINARY IMAGE]</string>
</value>
</member>
</struct>
</value>
</param>
</params>
</methodResponse>
DeactivateQR
Deactivate a card.
Request
Path parameters
string, 10 characters, required
The Paymentology issued terminal ID of the terminal requesting the transaction
string, 16 characters, required
The full 16-digit card number
string, 1-40 characters, required
Transaction ID number generated by the calling client
date
Client generated / local transaction date to assist in identifying transactions on the client side
string, required
HMAC-SHA256 hashed signature of the concatenated method name with all argument values using the terminal password as private key
<methodCall>
<methodName>DeactivateQR</methodName>
<params>
<param>
<value>
<string>0011122411</string>
</value>
</param>
<param>
<value>
<string>AFAAFFK121</string>
</value>
</param>
<param>
<value>
<string>11111111</string>
</value>
</param>
<param>
<value>
<dateTime.iso8601>20180328T12:02:09+0200</dateTime.iso8601>
</value>
</param>
<param>
<value>
<string>BCF11A9E1111FFC203301333C6008CE61BCD2E91</string>
</value>
</param>
</params>
</methodCall>
Response
STATUS200 OK
Schema
integer
Status code indicating transaction result
string
Text indicating transaction result
<methodResponse>
<params>
<param>
<value>
<struct>
<member>
<name>resultCode</name>
<value>
<double>1</double>
</value>
</member>
<member>
<name>resultText</name>
<value>
<string>Approved</string>
</value>
</member>
</struct>
</value>
</param>
</params>
</methodResponse>
Was this page helpful?