LinkCardsBySequenceRange

Link multiple cards to a profile using a range of sequence numbers.

Request

Path parameters

terminalID

string,  10 characters,  required

The Paymentology issued terminal ID of the terminal requesting the transaction

profileNumber

string,  1-20 characters,  required

The profile to which to link the cards

startSequence

integer,  required

The starting sequence number from a range of cards to link

endSequence

integer,  required

The ending sequence number from a range of cards to link

transactionID

string,  1-255 characters,  required

Transaction ID number generated by the calling client

transactionDate

date,  required

Transaction date generated by the calling client

checksum

string,  required

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>LinkCardsBySequenceRange</methodName>
    <params>
        <param>
            <value>
                <string>ABC1234567</string>
            </value>
        </param>
        <param>
            <value>
                <string>12345</string>
            </value>
        </param>
        <param>
            <value>
                <int>100</int>
            </value>
        </param>
        <param>
            <value>
                <int>150</int>
            </value>
        </param>
        <param>
            <value>
                <string>ABCDE12345</string>
            </value>
        </param>
        <param>
            <value>
                <dateTime.iso8601>2023-11-08T12:34:56</dateTime.iso8601>
            </value>
        </param>
        <param>
            <value>
                <string>3b4c4444e1c4444d8e444a4c0c2c2d444e3d4444</string>
            </value>
        </param>
    </params>
</methodCall>

 

Response

STATUS200 OK

Schema

terminalID

string

Echo of incoming value

profileNumber

string

Echo of incoming value

startSequence

integer

Echo of incoming value

endSequence

integer

Echo of incoming value

cardsAlreadyLinked

array

An array containing a list of card sequence numbers that could not be linked because the cards have already been linked to a profile

sequenceNumber, Integer – Sequence number of a card that was already linked

clientTransactionID

string

Echo of incoming value

serverTransactionID

date

Transaction ID generated by Paymentology

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>12345</string>
                        </value>
                    </member>
                    <member>
                        <name>startSequence</name>
                        <value>
                            <int>100</int>
                        </value>
                    </member>
                    <member>
                        <name>endSequence</name>
                        <value>
                            <int>150</int>
                        </value>
                    </member>
                    <member>
                        <name>cardsAlreadyLinked</name>
                        <value>
                            <array>
                                <data>
                                    <value>
                                        <struct>
                                            <member>
                                                <name>sequenceNumber</name>
                                                <value>
                                                    <int>120</int>
                                                </value>
                                            </member>
                                        </struct>
                                    </value>
                                    <value>
                                        <struct>
                                            <member>
                                                <name>sequenceNumber</name>
                                                <value>
                                                    <int>135</int>
                                                </value>
                                            </member>
                                        </struct>
                                    </value>
                                </data>
                            </array>
                        </value>
                    </member>
                    <member>
                        <name>clientTransactionID</name>
                        <value>
                            <string>ABCDE12345</string>
                        </value>
                    </member>
                    <member>
                        <name>serverTransactionID</name>
                        <value>
                            <string>2023-11-08T12:44:44Z</string>
                        </value>
                    </member>
                    <member>
                        <name>resultCode</name>
                        <value>
                            <int>0</int>
                        </value>
                    </member>
                    <member>
                        <name>resultText</name>
                        <value>
                            <string>Transaction successful</string>
                        </value>
                    </member>
                </struct>
            </value>
        </param>
    </params>
</methodResponse>

 

Was this page helpful?

Are you ready to use our APIs

If you are not yet registered with us.

Still have questions? Contact us.