AllocateCreateVirtualCard

Create a virtual card with specified amount loaded, linked to the specified profile and allocated to a cardholder with specified details.

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
loadAmount	Integer		✓	Amount loaded on card; ; NB. A Virtual Card can be created without having any amount loaded on it
firstName	String	1-50 characters	✓	The first name of the bearer
lastName	String	1-50 characters	✓	The last name of the bearer
idOrPassportNumber	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-SHA256 hashed signature of the concatenated method name with all argument values using the terminal password as private key

<?xml version="1.0" encoding="UTF-8"?>
<methodCall>
  <methodName>AllocateCreateVirtualCard</methodName>
  <params>
    <param>
      <value>
        <string>0010637531</string>
      </value>
    </param>
    <param>
      <value>
        <string>9975224335</string>
      </value>
    </param>
    <param>
      <value>
        <int>100</int>
      </value>
    </param>
    <param>
      <value>
        <string>Mili</string>
      </value>
    </param>
    <param>
      <value>
        <string>Thethe</string>
      </value>
    </param>
    <param>
      <value>
        <string>20201802146184</string>
      </value>
    </param>
    <param>
      <value>
        <string>071523456</string>
      </value>
    </param>
    <param>
      <value>
        <string>12345</string>
      </value>
    </param>
    <param>
      <value>
        <dateTime.iso8601>20220908T07:19:00</dateTime.iso8601>
      </value>
    </param>
    <param>
      <value>
        <string>DE6E77FDBE87B723B0E5193EDAFAF2D065DC76A7</string>
      </value>
    </param>
  </params>
</methodCall>

Response Parameters

Parameter	type	Description
clientTransactionID	String	Echo
terminalID	String	Echo
resultCode	Integer	Status code indicating transaction result
loadAmount	Integer	Echo
profileNumber	String	Echo
resultText	String	Text indicating transaction result
serverTransactionID	String	Transaction ID number generated by Paymentology
trackingNumber	String	The tracking number of the virtual card

<?xml version="1.0" encoding="UTF-8"?>
<methodResponse>
    <params>
        <param>
            <value>
                <struct>
                    <member>
                        <name>clientTransactionID</name>
                        <value>
                            <string>62e05bd2ec215</string>
                        </value>
                    </member>
                    <member>
                        <name>terminalID</name>
                        <value>
                            <string>0041702204</string>
                        </value>
                    </member>
                    <member>
                        <name>resultCode</name>
                        <value>
                            <int>1</int>
                        </value>
                    </member>
                    <member>
                        <name>cvv</name>
                        <value>
                            <string>309</string>
                        </value>
                    </member>
                    <member>
                        <name>loadAmount</name>
                        <value>
                            <int>1</int>
                        </value>
                    </member>
                    <member>
                        <name>profileNumber</name>
                        <value>
                            <string>4697222109</string>
                        </value>
                    </member>
                    <member>
                        <name>expires</name>
                        <value>
                            <string>07/2025</string>
                        </value>
                    </member>
                    <member>
                        <name>resultText</name>
                        <value>
                            <string>OK</string>
                        </value>
                    </member>
                    <member>
                        <name>serverTransactionID</name>
                        <value>
                            <string>4697222109-87895d54ae1e0942b722a0d88726cac36ba03234</string>
                        </value>
                    </member>
                    <member>
                        <name>voucherNumber</name>
                        <value>
                            <string>5192606332506436</string>
                        </value>
                    </member>
                    <member>
                        <name>trackingNumber</name>
                        <value>
                            <string>523642889652452</string>
                        </value>
                    </member>
                </struct>
            </value>
        </param>
    </params>
</methodResponse>