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

Parameter	type	Limits	required	Description
terminalID	String	10 characters	✓	The Paymentology issued terminal id of the terminal requesting the transaction
title	String	special - see description	✓	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.)
initials	String	special - see description	✓	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.)
lastName	String	special - see description	✓	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.Spaces are allowed to accomodate compounded surnames like DE LA CRUZ and parental and maternal names like GARCIA FERNANDEZ. (The combined value of title, initials and surname delimited with spaces should be maximum 20 characters.); Field is required but can accept empty string.
address1	String	special - see description	✓	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.
address2	String	special - see description	✓	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.
address3	String	special - see description	✓	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.
address4	String	special - see description	✓	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.
address5	String	special - see description	✓	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.
additionalData	String	special - see description	✓	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.
transactionID	String	1-255 characters	✓	a unique identifier generated by the client, which must not be duplicated over time.
transactionDate	Date		✓	Client generated / local Transaction Date to assist in identifying transactions on the client side
checksum	String		✓	HMAC-SHA256 hashed signature of the concatenated method name with all argument values using the terminal password as private key

xml

OrderCard

0014682067

Miss

Tester

Tutuka

7 Plein

Wanderers

Johannesburg

2001

South Africa

test123

123456

20200327T00:00:00

47E71AB6DD2D292A585399BAF8757E1352DBAA64


```xml

  OrderCard

        0014682067

        Miss

        Tester

        Tutuka

        7 Plein

        Wanderers

        Johannesburg

        2001

        South Africa

        test123

        123456

        20200327T00:00:00

        47E71AB6DD2D292A585399BAF8757E1352DBAA64


            resultCode

              1

            resultText

              Approved