AllocateCreateVirtualCard
Create a virtual card with specified amount loaded, linked to the specified profile and allocated to a cardholder with specified details.
Request
Path parameters
string, 10 characters, required
The Paymentology issued terminal ID of the terminal requesting the transaction
string, 1-20 characters, required
Profile number linked with this card
integer, required
Amount loaded on card
NB. A Virtual Card can be created without having any amount loaded on it
string, 1-50 characters, required
The first name of the bearer
string, 1-50 characters, required
The last name of the bearer
string, 1-50 characters, required
The identification number or passport number for the bearer
string, 1-10 characters, required
The Mobile Phone Number of the bearer
string, 1-255 characters, required
Transaction ID number generated by the calling client
date, required
Transaction date generated by the calling client
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>AllocateCreateVirtualCard</methodName>
<params>
<param>
<value>
<string>0010637531</string>
</value>
</param>
<param>
<value>
<string>9975224335</string>
</value>
</param>
<param>
<value>
<int>100</int>
</value>
</param>
<param>
<value>
<string>Mili</string>
</value>
</param>
<param>
<value>
<string>Thethe</string>
</value>
</param>
<param>
<value>
<string>20201802146184</string>
</value>
</param>
<param>
<value>
<string>071523456</string>
</value>
</param>
<param>
<value>
<string>12345</string>
</value>
</param>
<param>
<value>
<dateTime.iso8601>20220908T07:19:00</dateTime.iso8601>
</value>
</param>
<param>
<value>
<string>DE6E77FDBE87B723B0E5193EDAFAF2D065DC76A7</string>
</value>
</param>
</params>
</methodCall>
Response
STATUS200 OK
Schema
string
Echo
string
Echo
integer
Status code indicating transaction result
integer
Echo
string
Echo
string
Text indicating transaction result
string
Transaction ID number generated by Paymentology
string
The tracking number of the virtual card
<?xml version="1.0" encoding="UTF-8"?>
<methodResponse>
<params>
<param>
<value>
<struct>
<member>
<name>clientTransactionID</name>
<value>
<string>62e05bd2ec215</string>
</value>
</member>
<member>
<name>terminalID</name>
<value>
<string>0041702204</string>
</value>
</member>
<member>
<name>resultCode</name>
<value>
<int>1</int>
</value>
</member>
<member>
<name>cvv</name>
<value>
<string>309</string>
</value>
</member>
<member>
<name>loadAmount</name>
<value>
<int>1</int>
</value>
</member>
<member>
<name>profileNumber</name>
<value>
<string>4697222109</string>
</value>
</member>
<member>
<name>expires</name>
<value>
<string>07/2025</string>
</value>
</member>
<member>
<name>resultText</name>
<value>
<string>OK</string>
</value>
</member>
<member>
<name>serverTransactionID</name>
<value>
<string>4697222109-87895d54ae1e0942b722a0d88726cac36ba03234</string>
</value>
</member>
<member>
<name>voucherNumber</name>
<value>
<string>5192606332506436</string>
</value>
</member>
<member>
<name>trackingNumber</name>
<value>
<string>523642889652452</string>
</value>
</member>
</struct>
</value>
</param>
</params>
</methodResponse>
Was this page helpful?