Create a virtual card in the campaign identified by its UUID and linked to the customer reference given.
Request Path Parameters
| Parameter | type | Limits | required | Description |
|---|---|---|---|---|
| terminalID | String | 10 characters | ✓ | The Paymentology issued terminal id of the terminal requesting the transaction |
| campaignUUID | String | 1-35 characters | ✓ | Indicator for which campaign the card is to be created |
| customerReference | String | 1-255 characters | ✓ | Customer reference linked with this card |
| cardLabel | String | 1-20 characters | ✓ | A string to label the card for the customer’s ease |
| notificationNumber | String | 1-20 characters | ✓ | The contact number for receiving SMS transaction notifications |
| expiryDate | Date | ✓ | The date on which the virtual card should expire | |
| transactionID | String | 1-255 characters | ✓ | A unique identifier generated by the client, which must not be duplicated over time. |
| transactionDate | Date | ✓ | Transaction date generated by the calling client | |
| checksum | String | ✓ | HMAC-SHA256 hashed signature of the concatenated method name with all argument values using the terminal password as private key |
<methodCall>
<methodName type="xs:string">CreateVirtualCard</methodName>
<params>
<param>
<value>
<string>1234567890</string>
</value>
</param>
<param>
<value>
<string>1234A5BC-567D-8910-9DEA0D87AD654DA0</string>
</value>
</param>
<param>
<value>
<string>TEST_CUSTOMER</string>
</value>
</param>
<param>
<value>
<string>TestCard</string>
</value>
</param>
<param>
<value>
<string>1122334455</string>
</value>
</param>
<param>
<value>
<dateTime.iso8601>20161125T00:00:00</dateTime.iso8601>
</value>
</param>
<param>
<value>
<string>d12d3df4-5e14-45a5-a32c-678c1234dfdb</string>
</value>
</param>
<param>
<value>
<dateTime.iso8601>20160525T00:00:00</dateTime.iso8601>
</value>
</param>
<param>
<value>
<string>123DC4F5BD12345678E9F0FBDF0DCE1234BEDF56</string>
</value>
</param>
</params>
</methodCall>
Response Parameters
| Field | type | Description |
|---|---|---|
| terminalID | String | Echo |
| campaignUUID | String | Echo |
| customerReference | String | Echo |
| cardLabel | String | Echo |
| notificationNumber | String | Echo |
| trackingNumber | String | The tracking number of the created virtual card. |
| cardNumber | String | The full 16-digit card number |
| cvv2 | String | The CVV2 for the card |
| expiryDate | Date | The expiry date of the created virtual card |
| clientTransactionID | String | Echo |
| serverTransactionID | String | Transaction id number generated by Paymentology |
| resultCode | Integer | Status code indicating transaction result |
| resultText | String | Text indicating transaction result |
<methodResponse>
<params>
<param>
<value>
<struct>
<member>
<name>customerReference</name>
<value>
<string>TEST_CUSTOMER</string>
</value>
</member>
<member>
<name>resultText</name>
<value>
<string>Approved</string>
</value>
</member>
<member>
<name>serverTransactionID</name>
<value>
<string>1234A5BC-567D-8910-9DEA0D87AD654DA0</string>
</value>
</member>
<member>
<name>expiryDate</name>
<value>
<dateTime.iso8601>20161125T00:00:00</dateTime.iso8601>
</value>
</member>
<member>
<name>cardLabel</name>
<value>
<string>TestCard</string>
</value>
</member>
<member>
<name>clientTransactionID</name>
<value>
<string>d12d3df4-5e14-45a5-a32c-678c1234dfdb</string>
</value>
</member>
<member>
<name>cvv2</name>
<value>
<string>123</string>
</value>
</member>
<member>
<name>resultCode</name>
<value>
<int>1</int>
</value>
</member>
<member>
<name>terminalID</name>
<value>
<string>1234567890</string>
</value>
</member>
<member>
<name>cardNumber</name>
<value>
<string>1234561674688710</string>
</value>
</member>
<member>
<name>campaignUUID</name>
<value>
<string>1234A5BC-567D-8910-9DEA0D87AD654DA0</string>
</value>
</member>
<member>
<name>notificationNumber</name>
<value>
<string>0123456789</string>
</value>
</member>
<member>
<name>trackingNumber</name>
<value>
<string>123456789874561</string>
</value>
</member>
</struct>
</value>
</param>
</params>
</methodResponse>