PocketTransfer

Transfer funds between two pockets linked to a card identified by tracking number.

Request

Path parameters

terminalID

string, 10 characters, required

The Paymentology issued terminal ID of the terminal requesting the transaction

customerReference

string, 1-20 characters, required

Customer reference linked with this card

trackingNumber

string, required

The tracking number of the card that the pockets are linked to

pocketTypeUUIDFrom

string, required

The UUID of the pocket to transfer funds from

pocketTypeUUIDTo

string, required

The UUID of the pocket to transfer funds to

requestAmount

integer, required

The requested amount to be transfered

transactionID

string, 1-255 characters, required

A unique identifier generated by the client, which must not be duplicated over time.

transactionDate

date, required

Transaction date generated by the calling client

checksum

string, required

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>

Response

STATUS200 OK

Schema

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

<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>

BACK TO CARD API MENU

Request

Path parameters

Response

STATUS200 OK

Schema

Are you ready to use our APIs