LinkCard
Link a card to a reference with the given bearer details. Linking a card will not activate it. Inactive cards need to be activated using the Activate call before they will become functional.
Request
Path parameters
string, 10 characters, required
The Paymentology issued terminal ID of the terminal requesting the transaction
string, 1-255 characters, required
The user defined reference to the card; for example a member id or wallet number
string, 1-20 characters, required
The card number, sequence number or tracking number of the specified card. This parameter can’t be empty for this call
string, 0-50 characters, required
The first name of the card bearer. Field is required but can accept empty string
string, 0-50 characters, required
The last name of the card bearer. Field is required but can accept empty string
string, 0-20 characters, required
The ID or passport number of the card bearer. Field is required but can accept empty string
string, 0-20 characters, required
The cellphone number of the card bearer. Field is required but can accept empty string
string, 1-255 characters, required
a unique identifier generated by the client, which must not be duplicated over time.
date, required
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>LinkCard</methodName>
<params>
<param>
<value>
<string>1063242391</string>
</value>
</param>
<param>
<value>
<string>27091309</string>
</value>
</param>
<param>
<value>
<string>5267237340995161</string>
</value>
</param>
<param>
<value>
<string>Themba</string>
</value>
</param>
<param>
<value>
<string>Mcube</string>
</value>
</param>
<param>
<value>
<string>7932365284082</string>
</value>
</param>
<param>
<value>
<string>0879223942</string>
</value>
</param>
<param>
<value>
<string>test-id</string>
</value>
</param>
<param>
<value>
<dateTime.iso8601>20170312T23:00:12</dateTime.iso8601>
</value>
</param>
<param>
<value>
<string>3CE2EAFB02DF179B703A4B3BBA9A31CA8078D8B1</string>
</value>
</param>
</params>
</methodCall>
Response
STATUS200 OK
Schema
integer
Status code indicating transaction result
<?xml version="1.0" encoding="UTF-8"?>
<methodResponse>
<params>
<param>
<value>
<struct>
<member>
<name>resultCode</name>
<value>
<int>1</int>
</value>
</member>
<member>
<name>resultText</name>
<value>
<string>Approved</string>
</value>
</member>
</struct>
</value>
</param>
</params>
</methodResponse>
Was this page helpful?