PocketTransfer

Transfer funds between two pockets linked to a card identified by 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-20 characters	✓	Customer reference linked with this card
trackingNumber	String		✓	The tracking number of the card that the pockets are linked to
pocketTypeUUIDFrom	String		✓	The UUID of the pocket to transfer funds from
pocketTypeUUIDTo	String		✓	The UUID of the pocket to transfer funds to
requestAmount	Integer		✓	The requested amount to be transfered
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>PocketTransfer</methodName>
    <params>
        <param>
            <value>
                <string>0049641801</string>
            </value>
        </param>
        <param>
            <value>
                <string>seantest</string>
            </value>
        </param>
        <param>
            <value>
                <string>seantest</string>
            </value>
        </param>
        <param>
            <value>
                <string>7353285846514770</string>
            </value>
        </param>
        <param>
            <value>
                <string>7353287463322990</string>
            </value>
        </param>
        <param>
            <value>
                <int>10</int>
            </value>
        </param>
        <param>
            <value>
                <string>006001007020700#31180000#PP0914799521</string>
            </value>
        </param>
        <param>
            <value>
                <dateTime.iso8601>20170828T12:56:00</dateTime.iso8601>
            </value>
        </param>
        <param>
            <value>
                <string>99E33A75B0601BDBF839FBF38D546AC71256F631</string>
            </value>
        </param>
    </params>
</methodCall>

``````xml
<methodResponse>
    <params>
        <param>
            <value>
                <struct>
                    <member>
                        <name>clientTransactionID</name>
                        <value>
                            <string>006001007020700#31180000#PP0914799521</string>
                        </value>
                    </member>
                    <member>
                        <name>resultCode</name>
                        <value>
                            <int>-4</int>
                        </value>
                    </member>
                    <member>
                        <name>terminalID</name>
                        <value>
                            <string>0049641801</string>
                        </value>
                    </member>
                    <member>
                        <name>requestAmount</name>
                        <value>
                            <int>10</int>
                        </value>
                    </member>
                    <member>
                        <name>customerReference</name>
                        <value>
                            <string>seantest</string>
                        </value>
                    </member>
                    <member>
                        <name>resultText</name>
                        <value>
                            <string>Invalid card number or reference</string>
                        </value>
                    </member>
                    <member>
                        <name>pocketUUIDFrom</name>
                        <value>
                            <string>7353285846514770</string>
                        </value>
                    </member>
                    <member>
                        <name>pocketUUIDTo</name>
                        <value>
                            <string>7353287463322990</string>
                        </value>
                    </member>
                    <member>
                        <name>serverTransactionID</name>
                        <value>
                            <string>D7B49FB8-155D-00FA-4D47DD3EE6E57EF5</string>
                        </value>
                    </member>
                    <member>
                        <name>trackingNumber</name>
                        <value>
                            <string>seantest</string>
                        </value>
                    </member>
                    <member>
                        <name>balance</name>
                        <value>
                            <array>
                                <data  />
                            </array>
                        </value>
                    </member>
                </struct>
            </value>
        </param>
    </params>
</methodResponse>

Response Parameters

Field	type	Description
terminalID	String	Echo
customerReference	String	Echo
trackingNumber	String	Echo
pocketTypeUUIDFrom	String	Echo
pocketTypeUUIDTo	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
authNumber	String	Authorization number for transaction
expiryDate	Date	The expiry date of the card