Transfer funds from one card to another identified by tracking numbers, using pockets if applicable of the same type.
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-20 characters | ✓ | Customer reference linked with this card |
| trackingNumberFrom | String | 1-20 characters | ✓ | The tracking number of the card to deduct the requested amount from |
| trackingNumberTo | String | 1-20 characters | ✓ | The tracking number of the card to load the requested amount on |
| pocketUUID | String | 0-255 characters | ✓ | The UUID of the type of pocket to transfer funds between, else empty if not applicable |
| requestAmount | Integer | ✓ | The requested amount to be loaded on the card and deducted from the profile | |
| 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 | 1-255 characters | ✓ | HMAC-SHA256 hashed signature of the concatenated method name with all argument values using the terminal password as private key |
<methodCall>
<methodName>TransferFunds</methodName>
<params>
<param>
<value>
<string>0042128722</string>
</value>
</param>
<param>
<value>
<string>Tutuka Test</string>
</value>
</param>
<param>
<value>
<string>687653400000962</string>
</value>
</param>
<param>
<value>
<string>351453400000961</string>
</value>
</param>
<param>
<value>
<string>
</string>
</value>
</param>
<param>
<value>
<int>5000</int>
</value>
</param>
<param>
<value>
<string>4857467</string>
</value>
</param>
<param>
<value>
<dateTime.iso8601>20161024T14:56:05</dateTime.iso8601>
</value>
</param>
<param>
<value>
<string>3FE248DA615358BDBE23C3AA1A356378A9868A81</string>
</value>
</param>
</params>
</methodCall>
Response Parameters
| Field | type | Description |
|---|---|---|
| terminalID | String | Echo |
| customerReference | String | Echo |
| trackingNumberFrom | String | Echo |
| trackingNumberTo | String | Echo |
| pocketUUID | String | Echo |
| requestAmount | Integer | Echo |
| clientTransactionID | String | Echo |
| serverTransactionID | String | Transaction id number generated by Paymentology |
| balance | Array | Balances of pockets linked to the card |
| resultCode | Integer | Status code indicating transaction result |
| resultText | String | Status text indicating transaction result |
<methodResponse>
<params>
<param>
<value>
<struct>
<member>
<name>clientTransactionID</name>
<value>
<string>4857467</string>
</value>
</member>
<member>
<name>resultCode</name>
<value>
<int>1</int>
</value>
</member>
<member>
<name>terminalID</name>
<value>
<string>0042128722</string>
</value>
</member>
<member>
<name>requestAmount</name>
<value>
<int>5000</int>
</value>
</member>
<member>
<name>customerReference</name>
<value>
<string>Tutuka Test</string>
</value>
</member>
<member>
<name>resultText</name>
<value>
<string>Approved</string>
</value>
</member>
<member>
<name>pocketUUID</name>
<value>
<string>
</string>
</value>
</member>
<member>
<name>trackingNumberTo</name>
<value>
<string>351453400000961</string>
</value>
</member>
<member>
<name>serverTransactionID</name>
<value>
<string>A3A67D85-155D-00FA-4DCD9DA1DB01532F</string>
</value>
</member>
<member>
<name>trackingNumberFrom</name>
<value>
<string>687653400000962</string>
</value>
</member>
<member>
<name>balance</name>
<value>
<array>
<data>
<value>
<struct>
<member>
<name>currency</name>
<value>
<string>840</string>
</value>
</member>
<member>
<name>amount</name>
<value>
<int>5000</int>
</value>
</member>
<member>
<name>pocketUUID</name>
<value>
<string>CABCCA6F-155D-0028-
9D9D270F6F1C5369</string>
</value>
</member>
</struct>
</value>
</data>
</array>
</value>
</member>
</struct>
</value>
</param>
</params>
</methodResponse>