New-Card

NewCard

The New Card API creates a new card for the given cardholder. The card will be sent through fullfilemnt (probably post mail) and its number and account are created in realtime. Card physical creation is done once, daily, by a batch file sent to the fulfillment house. The API contains all data relevant to cardholder (as address, city, etc).

Input Parameters:

Name

Required

Definition

Comments

AddressLine1

Format: Alphanumeric, 1-30 Can contains as well all special characters beside: <, >

AddressLine2

Format: Alphanumeric, 1-30 Can contains as well all special characters beside: <, >

CampaignCode

Format: Alphanumeric, 1-120

City

Format: Alpha, 1-20 Can contains as well these special characters: /, -, space, comma, period, &

DateOfBirth

Format: yyyy-mm-dd Description: Cardholder must be above 17 years old

DocExpirationDate

Format: YYYY-MM-DD Description: must be after DocIssueDate. Conditional value required only when DocType is 'PASS' 'IDL' 'UDL'or 'MCN'

Conditional value required only when DocType is 'PASS' 'IDL' 'UDL'or 'MCN' AND SecondaryCard param exist and is different than “Y”

DocId

Format: Alphanumeric, 3-16 Description: ID number of the government identification document used (defined in DocType)

DocIssueDate

Format: YYYY-MM-DD Description: must be before DocExpirationDate Conditional value required only when DocType is 'PASS' or 'MCN'

Conditional value required only when DocType is 'PASS' or 'MCN' AND SecondaryCard param exist and is different than “Y”

DocIssuer

Format: Alphanumeric, 2 Description: Country/State code. Conditional value required only when DocType is 'PASS' 'IDL' 'UDL'or 'MCN'

Conditional value required only when DocType is 'PASS' 'IDL' 'UDL'or 'MCN' AND SecondaryCard param exist and is different than “Y”

DocType

Format options: SSN PASS UDL MCN INMATE Description: Closed list of values.Type of government identification document used: SSN- Social Security Number, PASS - Passport number, 'UDL' – US Drivers license number,'MCN' - Matricula consular ,INMATE.

Format General o An email address is made up of a local part, an @ symbol, then a domain part (XXXXX@XXXXX) o Full Email Address Maximum Size: 254 chars o Local part & domain consist of labels separated by dots — Each label max size is 64 — Two successive dots are forbidden — mail cannot start or end with a dot — Labels cannot not start with a hyphen, end with a hyphen, or contain two successive hyphens. Local part o Size: 1-64 chars o Allowed Chars: a-z, A-Z, 0-9, and special characters: - _ . ~ ! ' * Domain part o Size: 1-251 chars o Allowed Chars: a-z, A-Z, 0-9, and special characters: - _ .

EnrollCashback

Format:Y/N

EnrollMailNotification

Format:Y/N

Fax

Format: Numeric, 6-10 Description: the fax number.

FirstName

Format: Alpha, 2-50 Can contains as well these special characters: /, -, space, comma, period, &

IsReceiveSms

Format options: Enabled (the cardholder has requested to receive an SMS for transactions and therefore he get SMS's) Disabled (the cardholder has requested to not receive an SMS for transactions and therefore he does not get SMS's) Blank (the cardholder has not requested to receive an SMS for transactions and therefore he does not get SMS's) Mail (the cardholder has requested to receive an mail for transactions and therefore he get mails) Description:Defines if the cardholder gets an SMS/Mail.

LastName

Format: Alpha, 2-50 Can contains as well these special characters: /, -, space, comma, period, &

Latitude

Format: Alphanumeric, Comma, Dot, "-", 1-8 (can be 40.71435) Description: Latitude can range between 0 and 90 degrees, and can be north or south. (Zero degrees latitude is neither north nor south.) The North Pole is at 90° north latitude; the South Pole is at 90° south latitude. The Equator is at zero degrees latitude.

Longitude

Format: Alphanumeric, Comma, Dot, "-", 1-9 (can be -74.00597) Description: Longitude can range between 0 and 180 degrees, and can be east or west. (Zero and 180 degrees longitude are neither east nor west.) The Greenwich Meridian, which passes through the United Kingdom, is at zero degrees longitude (unlike zero degrees latitude, the zero point for longitude is just an arbitrary choice, made for historical reasons).

MiddleInitial

Format: Alpha,1 Description: Middle name char of the cardholder.

MobilePhone

Format: Numeric, 6-10 Description: Mobile Phone number

MobilePhone is required only if IsReceiveSms=Enabled

Phone

Format: Numeric, 6-10 Description: Phone number

ProductTypeName

Format: Alphanumeric, 1-120 Description: Each sub program in Praxell consists of one or more product types. A product type is a set of attributes that are applied to the cards that belong to this product type. The ProductTypeName field is the name of the product used when creating and issuing cards.

It is not required and not relevant if Secondary Card param is Y. Otherwise, it is required

ReferralCode

Format: Alphanumeric, 1-120

SecondaryCard

Format: Y/N (default)

ShippingAddressLine1

Format: Alphanumeric, 30 Can contains as well all special characters beside: <, >

relevant if UseShippingDetails=Y

ShippingAddressLine2

Format: Alphanumeric, 30 Can contains as well all special characters beside: <, >

relevant if UseShippingDetails=Y

ShippingCity

Format: Alpha, 1-20 Can contains as well these special characters: /, -, space, comma, period,

relevant if UseShippingDetails=Y

ShippingState

Format: Alphanumeric, 2

relevant if UseShippingDetails=Y

ShippingZIP

Format: Numeric, 5

relevant if UseShippingDetails=Y

SkipVerification

Format Options: Y/N (default: N) Description: Allow to skip verification attempt done by API. in such cases, the cardholder will be created in RNV (Registered Not Verified) mode

State

Format: Alphanumeric, 2

Title

Format: List “Ms.”, “Mr.”

Token

Format: Number, 6 Description: Six digits value (should be unique for a period of N minutes (where N is a system parameter)

UserDefined1