AddPocket

Add a pocket for the type indicated by UUID to a card identified by tracking number

Request Path Parameters

ParametertypeLimitsrequiredDescription
terminalIDString10 characters✓The Paymentology issued terminal id of the terminal requesting the transaction
customerReferenceString1-255 characters✓Customer reference linked with this card
trackingNumberString1-20 characters✓The tracking number of the card to add the pocket to
pocketUUIDString1-255 characters✓UUID of the type of pocket to be added (Paymentology will provide you with the available values for your particular case and campaign)
transactionIDString1-255 characters✓A unique identifier generated by the client, which must not be duplicated over time.
transactionDateDate✓Transaction date generated by the calling client
checksumString✓HMAC-SHA256 hashed signature of the concatenated method name with all argument values using the terminal password as private key
<methodCall>
    <methodName>AddPocket</methodName>
    <params>
        <param>
            <value>
                <string>0042128722</string>
            </value>
        </param>
        <param>
            <value>
                <string>Tutuka Test</string>
            </value>
        </param>
        <param>
            <value>
                <string>867959900000070</string>
            </value>
        </param>
        <param>
            <value>
                <string>E6FA7E37-155D-0028-9D2F13C986C114A6</string>
            </value>
        </param>
        <param>
            <value>
                <string>4857467</string>
            </value>
        </param>
        <param>
            <value>
                <dateTime.iso8601>20161024T17:47:10</dateTime.iso8601>
            </value>
        </param>
        <param>
            <value>
                <string>49E1663629BE79DE6ECD8AF1DA5E69B4508342AC</string>
            </value>
        </param>
    </params>
</methodCall>

Response Parameters

FieldtypeDescription
terminalIDStringEcho
customerReferenceStringEcho
trackingNumberStringEcho
pocketUUIDStringEcho
clientTransactionIDStringEcho
serverTransactionIDStringTransaction id number generated by Paymentology
resultCodeIntegerStatus code indicating transaction result
resultTextStringText 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>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>E6FA7E37-155D-0028-9D2F13C986C114A6</string>
                        </value>
                    </member>
                    <member>
                        <name>serverTransactionID</name>
                        <value>
                            <string>A9BE8AA5-155D-00FA-4D1697B62652ECA6</string>
                        </value>
                    </member>
                    <member>
                        <name>trackingNumber</name>
                        <value>
                            <string>867959900000070</string>
                        </value>
                    </member>
                </struct>
            </value>
        </param>
    </params>
</methodResponse>