Updates the expiry date of a virtual card
Request Path Parameters
| Parameter | type | Limits | required | Description |
|---|---|---|---|---|
| terminalID | String | 10 characters | ✓ | The Paymentology issued terminal id of the terminal requesting the transaction |
| customerReference | String | 1-255 characters | ✓ | Customer reference linked with this card |
| trackingNumber | String | 1-20 characters | ✓ | Tracking number that identifies the card to update the expiry date |
| expiryDate | Date | ✓ | Date which specifies when the card expires | |
| 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>UpdateCardExpiryDate</methodName>
<params>
<param>
<value>
<string>0008866376</string>
</value>
</param>
<param>
<value>
<string>TEST_CUSTOMER</string>
</value>
</param>
<param>
<value>
<string>787454700000007</string>
</value>
</param>
<param>
<value>
<dateTime.iso8601>20250101T09:00:00</dateTime.iso8601>
</value>
</param>
<param>
<value>
<string>169220210510T163500-sddd</string>
</value>
</param>
<param>
<value>
<dateTime.iso8601>20210601T16:06:43</dateTime.iso8601>
</value>
</param>
<param>
<value>
<string>297B3FE27017477DAC324FF3097F0607BDF0542C</string>
</value>
</param>
</params>
</methodCall>
``````xml
<?xml version="1.0" encoding="UTF-8"?>
<methodResponse>
<params>
<param>
<value>
<struct>
<member>
<name>clientTransactionID</name>
<value>
<string>169220210510T163500-sddd</string>
</value>
</member>
<member>
<name>resultCode</name>
<value>
<int>1</int>
</value>
</member>
<member>
<name>terminalID</name>
<value>
<string>0008866376</string>
</value>
</member>
<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>5B1C433B-0C70-3F04-2C0D1061DA28D106</string>
</value>
</member>
<member>
<name>trackingNumber</name>
<value>
<string>787454700000007</string>
</value>
</member>
</struct>
</value>
</param>
</params>
</methodResponse>
Response Parameters
| Field | type | Description |
|---|---|---|
| terminalID | Integer | Echo |
| customerReference | Integer | Echo |
| trackingNumber | Integer | Echo |
| clientTransactionID | Integer | Echo |
| serverTransactionID | String | Transaction id number generated by Paymentology |
| resultCode | Integer | Status code indicating transaction result |
| resultText | String | Status text indicating transaction result |
