Link multiple cards to a profile using a range of sequence numbers.
Request Path Parameters
| Parameter | type | Limits | required | Description |
|---|---|---|---|---|
| terminalID | String | 10 characters | ✓ | The Paymentology issued terminal ID of the terminal requesting the transaction |
| profileNumber | String | 1-20 characters | ✓ | The profile to which to link the cards |
| startSequence | Integer | ✓ | The starting sequence number from a range of cards to link | |
| endSequence | Integer | ✓ | The ending sequence number from a range of cards to link | |
| transactionID | String | 1-255 characters | ✓ | Transaction ID number generated by the calling client |
| transactionDate | Date | ✓ | Transaction date generated by the calling client | |
| checksum | String | ✓ | 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 Parameters
| Parameter | type | Description |
|---|---|---|
| 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>