AllocateCard

Allocate a card to a bearer.

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	✓	Profile number linked with this card
cardIdentifier	String	1-20 characters	✓	The card number, sequence number or tracking number of the specified card
firstName	String	1-50 characters	✓	The first name of the bearer
lastName	String	1-50 characters	✓	The last name of the bearer
idOrPassport	String	1-50 characters	✓	The identification number or passport number for the bearer
cellphoneNumber	String	1-10 characters	✓	The Mobile Phone Number of the bearer
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>AllocateCard</methodName>
    <params>
        <param>
            <value>
                <string>123456890</string>
            </value>
        </param>
        <param>
            <value>
                <string>P55555</string>
            </value>
        </param>
        <param>
            <value>
                <string>C44444</string>
            </value>
        </param>
        <param>
            <value>
                <string>Lando</string>
            </value>
        </param>
        <param>
            <value>
                <string>Norris</string>
            </value>
        </param>
        <param>
            <value>
                <string>123456789</string>
            </value>
        </param>
        <param>
            <value>
                <string>555-5555</string>
            </value>
        </param>
        <param>
            <value>
                <string>T987654321</string>
            </value>
        </param>
        <param>
            <value>
                <string>2023-11-08</string>
            </value>
        </param>
        <param>
            <value>
                <string>f9a7ggg3d88e91ec1c9d1234a22e49f98a1c</string>
            </value>
        </param>
    </params>
</methodCall>

Response Parameters

Parameter	type	Description
terminalID	String	Echo of incoming value
profileNumber	String	Echo of incoming value
cardNumber	String	Number of the card found using the cardIdentifier
cardSequenceNumber	String	Sequence of the card found using the cardIdentifier
firstName	String	Echo of incoming value
lastName	String	Echo of incoming value
idOrPassport	String	Echo of incoming value
cellphoneNumber	String	Echo of incoming value
clientTransactionID	String	Echo of incoming value
serverTransactionID	String	Transaction id generated by Paymentology
resultCode	Integer	Status code indicating transaction result
resultText	String	Text indicating transaction result

<?xml version="1.0" encoding="UTF-8"?>
<methodResponse>
    <params>
        <param>
            <value>
                <struct>
                    <member>
                        <name>terminalID</name>
                        <value>
                            <string>1234567890</string>
                        </value>
                    </member>
                    <member>
                        <name>profileNumber</name>
                        <value>
                            <string>P12345</string>
                        </value>
                    </member>
                    <member>
                        <name>cardNumber</name>
                        <value>
                            <string>1234 4444 9012 4444</string>
                        </value>
                    </member>
                    <member>
                        <name>cardSequenceNumber</name>
                        <value>
                            <string>1</string>
                        </value>
                    </member>
                    <member>
                        <name>firstName</name>
                        <value>
                            <string>Lando</string>
                        </value>
                    </member>
                    <member>
                        <name>lastName</name>
                        <value>
                            <string>Norris</string>
                        </value>
                    </member>
                    <member>
                        <name>idOrPassport</name>
                        <value>
                            <string>123456789</string>
                        </value>
                    </member>
                    <member>
                        <name>cellphoneNumber</name>
                        <value>
                            <string>555-5555</string>
                        </value>
                    </member>
                    <member>
                        <name>clientTransactionID</name>
                        <value>
                            <string>T987654321</string>
                        </value>
                    </member>
                    <member>
                        <name>serverTransactionID</name>
                        <value>
                            <string>ST123456789</string>
                        </value>
                    </member>
                    <member>
                        <name>resultCode</name>
                        <value>
                            <int>200</int>
                        </value>
                    </member>
                    <member>
                        <name>resultText</name>
                        <value>
                            <string>Card allocated successfully</string>
                        </value>
                    </member>
                </struct>
            </value>
        </param>
    </params>
</methodResponse>