Name
Description
Type
Additional information
Title

The cardholder’s title (Mr, Mrs, Miss) If title is not empty, should be Mr Mrs Mr.

string

None.

firstName

The Cardholder's First Name. Note: Firstname and Lastname may only contain a maximum of 20 characters COMBINED.

string

Required

Matching regular expression pattern: ^[a-zA-Z\s]+$

lastName

The Cardholder's Last Name. Note:Firstname and Lastname may only contain a maximum of 20 characters COMBINED.

string

Required

Matching regular expression pattern: ^[a-zA-Z\s]+$

email

The Cardholder's Email. Cardholders will receive an activation email with an ACCESS CODE to activate and access their card on Cardportal.com.

string

Required

address1

The cardholder’s street number, address, and suite or apartment number.

string

Required

Matching regular expression pattern: ^[a-zA-Z0-9_\s\-\'\.\,\#\/]+$

address2

The cardholder’s address, such as a postal box number, suite #, buzz #. This information is optional.

string

None.

city

The Cardholder's city of residence.

string

Required

Matching regular expression pattern: ^[a-zA-Z\s]+$

state

The cardholder’s province or state of residence.

string

Required

Matching regular expression pattern: ^[a-zA-Z\s]+$

countryIso

A three-digit number(ISO) that identifies the cardholder’s country of residence. (ex. 826 for UK)

string

Required

String length: inclusive between 3 and 3

postalCode

Postal Code or Zip Code of the cardholder's address.

string

None.

dateOfBirth

The cardholder’s date of birth. (Format: YYYY-MM-DD)

date

None.

cityOfBirth

The Cardholder's city of birth

string

None.

idType

The code for the type of identification submitted by the cardholder. 1: Identity Card, 2: Passport Number, 3: Driving License, 4: Social Security Number

integer

None.

idNumber

The identification number for the selected IDType. It can include spaces and hyphens. This field is only required if an IDType is specified.

string

None.

mobile

The Cardholder's Mobile

string

Matching regular expression pattern: ^[\+]?[(]?[0-9]{0,3}[)]?[-\s\.]?[(]?[0-9]{3}[)]?[-\s\.]?[0-9]{3}[-\s\.]?[0-9]{4,6}$

initialLoadAmount

The amount to load on the card. Do not include commas or spaces.

decimal number

Required

Matching regular expression pattern: [\d]{0,4}([.,][\d]{1,2})?

currency

Card's Currency to be issued in (USD, EUR, GBP,...)

string

Required

String length: inclusive between 3 and 3

remoteId

Reference Id From client which gets echoed back in response. ID provided by the Merchant.

string

None.

embossOrNot

Defines if the card should be embossed or gets issued with no name on it. Default is True

boolean

None.

embossLine4

The Name that will be embossed under Cardholder name on the card. 4th emboss line is used for Currency and extra possible info such as company's name etc.

string

String length: inclusive between 0 and 17

emailOrSmsOrNone

Defines if the cardholder should get notified via email=0, SMS=1, SMS and Email both=2, None=3 Default is 0

integer

None.

delivery

Define the deliver type (Standard = 0, Registered = 1, Courier = 2) Default is 0 (Standard)

Range: inclusive between 0 and 2

recipientName

Recipient Name used for those cards which are being sent as courier (Not Standard mail).

string

Matching regular expression pattern: ^[a-zA-Z\s]+$

recipientPhone

Recipient Mobile used for those cards which are being sent as courier (Not Standard mail).

string

None.

cardRequestType

Card type. Plastic = 0, Virtual = 1, ConvertToPlasticRequested = 2, Wallet = 3, MVC = 4

Required

Range: inclusive between 0 and 4

isDifferentShippingAddress

True, if the shipping address is different from cardholder's address, false otherwise

boolean

None.

createImage

True, if should create the image of the card, false otherwise

boolean

None.

bulkCode

Delivery bulk code. Cards with the same bulk code will be delivered together to the same address.

string

None.

activate

Activate the card or not. Default is false.

boolean

None.

notify

True to send the email with create card notification, false in otherwise.

boolean

None.

deliveryAddress1

Delivery Address 1. If isDifferentShippingAddress is set as true, this field is mandatory

string

Matching regular expression pattern: ^[a-zA-Z0-9_\s\-\'\.\,\#\/]+$

deliveryAddress2

Delivery Address 2 If isDifferentShippingAddress is set as true, this field is mandatory

string

Matching regular expression pattern: ^[a-zA-Z0-9_\s\-\'\.\,\#\/]+$

deliveryAddress3

Delivery Address 3 If isDifferentShippingAddress is set as true, this field is mandatory

string

Matching regular expression pattern: ^[a-zA-Z0-9_\s\-\'\.\,\#\/]+$

deliveryCity

Delivery City If isDifferentShippingAddress is set as true, this field is mandatory

string

None.

deliveryState

Delivery County/State If isDifferentShippingAddress is set as true, this field is mandatory

string

None.

deliveryCountryIso

Delivery Country ISO Code (ex. 826 for UK) If isDifferentShippingAddress is set as true, this field is mandatory

string

None.

deliveryPostalCode

Delivery Post Code If isDifferentShippingAddress is set as true, this field is mandatory

string

None.

userName

The merchant group’s username. Provided by your account manager.

string

Required

password

The merchant group’s password. Provided by your account manager.

string

Required

serviceIndex

The merchant service index. Provided by your account manager.

string

Required

uniqId

A unique number (integer) with which the service is consumed. (This number is unique, random and cannot be reused) This number is unique by each service consumed

integer

Required

Range: inclusive between 1 and 2147483647

clientId

Partner's assigned Id number. Provided by your account manager.

integer

Required

Range: inclusive between 1 and 2147483647

transactionToken

Provided by your account manager.

string

Required

orginalPartnerId

integer

None.