Transfer funds from one card to another.
Request Path Parameters
| Parameter | type | Limits | required | Description |
|---|---|---|---|---|
| terminalID | String | 10 characters | ✓ | The Paymentology issued terminal ID of the terminal requesting the transaction |
| profileNumber | String | 1-20 characters | ✓ | The profile to which the card belongs, funds will be loaded to this profile |
| cardIdentifierFrom | String | 1-20 characters | ✓ | The card number, tracking number or sequence number of the card to deduct |
| cardIdentifierTo | String | 1-20 characters | ✓ | The card number, tracking number or sequence number of the card to load |
| requestAmount | Integer | ✓ | The requested amount to be loaded on the card and deducted from the profile, in cents | |
| transactionID | String | 1-255 characters | ✓ | Transaction ID number generated by the calling client |
| transactionDate | Date | ✓ | Transaction date generated by the calling client | |
| checksum | String | ✓ | HMAC-SHA1 hashed signature of the concatenated method name with all argument values using the terminal password as private key |
<?xml version="1.0"?>
<methodCall>
<methodName>TransferFunds</methodName>
<params>
<param>
<value>
<string>ABC1234567</string>
</value>
</param>
<param>
<value>
<string>P12345</string>
</value>
</param>
<param>
<value>
<string>987654321</string>
</value>
</param>
<param>
<value>
<string>123456789</string>
</value>
</param>
<param>
<value>
<string>987654321</string>
</value>
</param>
<param>
<value>
<int>1000</int>
</value>
</param>
<param>
<value>
<string>T987654321</string>
</value>
</param>
<param>
<value>
<dateTime.iso8601>2023-11-08T12:44:44</dateTime.iso8601>
</value>
</param>
<param>
<value>
<string>3b7c4444e1c4444d8e444a4c0c2c2d444e3d4444</string>
</value>
</param>
</params>
</methodCall>Response Parameters
| Parameter | type | Description |
|---|---|---|
| terminalID | String | Echo of incoming value |
| profileNumber | String | Echo of incoming value |
| cardNumberFrom | String | Number of the card found using the cardIdentifier |
| cardNumberTo | String | Number of the card found using the cardIdentifier |
| requestAmount | Integer | Echo of incoming value |
| clientTransactionID | String | Echo of incoming value |
| serverTransactionID | Date | Transaction ID generated by Paymentology |
| balanceAmount | Integer | Balance amount in cents |
| authNumber | String | Authorisation number for transaction |
| expiryDate | Date | The expiry date of the card |
| transactionFee | Integer | Transaction fee amount in cents |
| resultCode | Integer | Status code indicating transaction result |
| resultText | String | Text indicating transaction result |
<methodResponse>
<params>
<param>
<value>
<struct>
<member>
<name>terminalID</name>
<value>
<string>ABC1234567</string>
</value>
</member>
<member>
<name>profileNumber</name>
<value>
<string>P12345</string>
</value>
</member>
<member>
<name>cardNumberFrom</name>
<value>
<string>987654321</string>
</value>
</member>
<member>
<name>cardNumberTo</name>
<value>
<string>987654321</string>
</value>
</member>
<member>
<name>requestAmount</name>
<value>
<int>1000</int>
</value>
</member>
<member>
<name>clientTransactionID</name>
<value>
<string>T987654321</string>
</value>
</member>
<member>
<name>serverTransactionID</name>
<value>
<string>ST123456789</string>
</value>
</member>
<member>
<name>balanceAmount</name>
<value>
<int>5000</int>
</value>
</member>
<member>
<name>authNumber</name>
<value>
<string>123456</string>
</value>
</member>
<member>
<name>expiryDate</name>
<value>
<dateTime.iso8601>2023-12-31T00:00:00</dateTime.iso8601>
</value>
</member>
<member>
<name>transactionFee</name>
<value>
<int>50</int>
</value>
</member>
<member>
<name>resultCode</name>
<value>
<int>200</int>
</value>
</member>
<member>
<name>resultText</name>
<value>
<string>Funds transferred successfully</string>
</value>
</member>
</struct>
</value>
</param>
</params>
</methodResponse>