OrderCard
Order a card for a specific cardholder. A card can be printed with cardholder details by the card manufacturer. No commas, question marks or quotation marks are allowed in any of the fields.
Request
Path parameters
string, 10 characters, required
The Paymentology issued terminal ID of the terminal requesting the transaction
string, 1-35 characters, required
Indicator for which campaign the card is to be ordered for
string, special - see description, required
This field can be used to enter the person’s title (e.g. Mr / Ms / Mrs / Dr / etc). Field is required but can accept empty string.
(The combined value of title, initials and surname delimited with spaces should be maximum 20 characters.)
string, special - see description, required
This field can only contain alphabetic characters in UPPER CASE – no full stops are allowed between initials. Field is required but can accept empty string.
(The combined value of title, initials and surname delimited with spaces should be maximum 20 characters.)
string, special - see description , required
This field can only be alphabetic characters in UPPER CASE – no full stops and/or special characters are allowed. In the case of -double barrel- surnames, such as FABER-SMITH we may have a hyphen between the two parts of the surname but without any spaces.
(The combined value of title, initials and surname delimited with spaces should be maximum 20 characters.)
Field is required but can accept empty string.
string, special - see description, required
This is the first line of the address field which will be printed on a card mailer when required by the client – maximum length is 27 to 60 characters (Manufacturer dependent).
The field may not start (first character) with a comma, linefeed character, carriage return character, quotation marks or question mark.
Field is required but can accept empty string.
string, special - see description, required
This is the second line of the address field which will be printed on a card mailer when required by the client – maximum length is 27 to 60 characters (Manufacturer dependent).
The field may not start (first character) with a comma, linefeed character, carriage return character, quotation marks or question mark. Field is required but can accept empty string.
string, special - see description, required
This is the third line of the address field which will be printed on a card mailer when required by the client – maximum length is 27 to 60 characters (Manufacturer dependent).
The field may not start (first character) with a comma, linefeed character, carriage return character, quotation marks or question mark. Field is required but can accept empty string.
string, special - see description, required
This is the fourth line of the address field which will be printed on a card mailer when required by the client – maximum length is 27 to 60 characters (Manufacturer dependent).
The field may not start (first character) with a comma, linefeed character, carriage return character, quotation marks or question mark. Field is required but can accept empty string.
string, special - see description, required
This is the fifth line of the address field which will be printed on a card mailer when required by the client – maximum length is 27 to 60 characters (Manufacturer dependent).
The field may not start (first character) with a comma, linefeed character, carriage return character, quotation marks or question mark. Field is required but can accept empty string.
string, special - see description, required
Customer specific additional data. Format to be negotiated per client. Maximum length is 350 characters (Manufacturer dependent).This field should not contain comma or new line(LF/CF) characters . Field is required but can accept empty string.
string, 1-255 characters, required
A unique identifier generated by the client, which must not be duplicated over time.
date, required
Transaction date generated by the calling client
string, required
HMAC-SHA256 hashed signature of the concatenated method name with all argument values using the terminal password as private key
<?xml version=""1.0""?> <methodCall> <methodName>OrderCard</methodName> <params> <param> <value> <string>00134564</string> </value> </param> <param> <value> <string>1234-5678-9087</string> </value> </param> <param> <value> <string>Miss</string> </value> </param> <param> <value> <string>MT</string> </value> </param> <param> <value> <string>Tutuka</string> </value> </param> <param> <value> <string>7 Plein</string> </value> </param> <param> <value> <string>Wanderers</string> </value> </param> <param> <value> <string>Johannesburg</string> </value> </param> <param> <value> <string>2001</string> </value> </param> <param> <value> <string>South Africa</string> </value> </param> <param> <value> <string>test123</string> </value> </param> <param> <value> <string>123456</string> </value> </param> <param> <value> <dateTime.iso8601>20200327T00:00:00</dateTime.iso8601> </value> </param> <param> <value> <string>47E71AB6DD2D292A585399BAF8757E1352DBAA64</string> </value> </param> </params> </methodCall>
Response
STATUS200 OK
Schema
string
Echo
string
Echo
string
Echo
string
Echo
string
Echo
string
Echo
string
Echo
string
Echo
string
Echo
string
Echo
string
Echo
integer
Status code indicating transaction result
string
Status text indicating transaction result
<methodResponse> <params> <param> <value> <struct> <member> <name>terminalID</name> <value> <string>00134564</string> </value> </member> <member> <name>campaignUUID</name> <value> <string>1234-5678-9087</string> </value> </member> <member> <name>title</name> <value> <string>Miss</string> </value> </member> <member> <name>initials</name> <value> <string>MT</string> </value> </member> <member> <name>surname</name> <value> <string>Tutuka</string> </value> </member> <member> <name>address1</name> <value> <string>7 Plein</string> </value> </member> <member> <name>address2</name> <value> <string>Wanderers</string> </value> </member> <member> <name>address3</name> <value> <string>Johannesburg</string> </value> </member> <member> <name>address4</name> <value> <string>2001</string> </value> </member> <member> <name>address5</name> <value> <string>South Africa</string> </value> </member> <member> <name>additionalData</name> <value> <string>1234567</string> </value> </member> <member> <name>resultCode</name> <value> <int>1</int> </value> </member> <member> <name>resultText</name> <value> <string>Approved</string> </value> </member> </struct> </value> </param> </params> </methodResponse>
Was this page helpful?