Get the details of a card that is identified by the given tracking number.
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 be returned |
| 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">CardDetail</methodName>
<params>
<param>
<value>
<string>1234567890</string>
</value>
</param>
<param>
<value>
<string>TEST_CUSTOMER</string>
</value>
</param>
<param>
<value>
<string>123456789874561</string>
</value>
</param>
<param>
<value>
<string>d12d3df4-4e11-45a5-a11c-101c7175dfdb</string>
</value>
</param>
<param>
<value>
<dateTime.iso8601>20160525T00:00:00</dateTime.iso8601>
</value>
</param>
<param>
<value>
<string>1F008A133D69E482FEBEBB9A1120545DCFB4C4DD</string>
</value>
</param>
</params>
</methodCall>
Response Parameters
| Field | type | Description |
|---|---|---|
| terminalID | String | Echo |
| customerReference | String | Echo |
| trackingNumber | String | Echo |
| campaignUUID | String | The campaign UUID the card belongs to |
| cardLabel | String | The card label |
| cardNumber | String | The full 16-digit card number |
| cvv2 | String | The CVV2 for the card |
| expiryDate | Date | The expiry date of the card |
| balance | Array | Balances of pockets linked to the card |
| currency | String | The currency of this card |
| stopped | String | A text string explaining the reason the card is stopped, else an empty string for a card that is not stopped |
| 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>currency</name>
<value>
<string>840</string>
</value>
</member>
<member>
<name>customerReference</name>
<value>
<string>TEST_CUSTOMER</string>
</value>
</member>
<member>
<name>balanceAmount</name>
<value>
<int>0</int>
</value>
</member>
<member>
<name>resultText</name>
<value>
<string>Approved</string>
</value>
</member>
<member>
<name>serverTransactionID</name>
<value>
<string>12F34B5B-678D-9108-7DAE65F4321123CD</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-4e11-45a5-a11c-101c7175dfdb</string>
</value>
</member>
<member>
<name>cvv2</name>
<value>
<string>000</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>1234567898765432</string>
</value>
</member>
<member>
<name>stopped</name>
<value>
<string />
</value>
</member>
<member>
<name>campaignUUID</name>
<value>
<string>1234F2C8-155D-0028-9DEA0D24AD111DA0</string>
</value>
</member>
<member>
<name>trackingNumber</name>
<value>
<string>123456789874561</string>
</value>
</member>
</struct>
</value>
</param>
</params>
</methodResponse>