Instant-Issue-Card

InstantIssueCard

The Instant Issue Card API performs enablement by card number for cards, which are anonymous. In addition, the API gets cardholder registration details and register an existing anonymous card to that cardholder.

Input Parameters:

Name
Required
Definition
Comments

AddressLine1

Y

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

AddressLine2

N

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

Amount

N

Format: Numeric, 1-9 Description: The amount is in cents.

CardNumber

C

Format: Numeric, 16

City

Y

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

Country

Y

Format: ISO Country code. Two characters. Description: Based on ISO 3166-1 alpha-2 list. http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2

Value "US" expected

DateOfBirth

Y

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

Description

N

Format: Alphanumeric, 1-30

DocExpirationDate

C

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

DocId

Y

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

DocIssueDate

C

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

DocIssuer

C

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

DocType

Y

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.

Email

N

Format: a-z (upper or lower), numbers, dash and underscore, 5-40 Description: Possible pattern: x@x.x

Fax

N

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

FirstName

Y

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

IsReceiveSms

N

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.

IssueWithoutVerification

N

Format: Y/N Description: Allows to issue a card without verification. Closed list values

LastName

Y

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

MiddleInitial

N

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

MobilePhone

C

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

MobilePhone is required only if IsReceiveSms=Enabled

OOWAnswer

C

Field:TBD

future

OOWQuestionType

N

Field:TBD

future

OperationType

N

Format options: CardNumber RPID

Phone

Y

Format: Numeric, 6-10 Description: Phone number

ReturnOOWQuestions

N

Format: Y/N (N is default).

future

RPID

C

Format: Numeric, 1-19

ShippingAddressLine1

Y

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

ShippingAddressLine2

Y

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

ShippingCity

Y

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

ShippingState

Y

Format: Alphanumeric, 2

ShippingZIP

Y

Format: Numeric, 5

SkipVerification

N

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

Y

Format: Alphanumeric, 2

UserDefined1

N

Format: Chars: a-zA-Z0-9 .,#$()/:?-%+*&;@!~=_' Size: 255

UserDefined2

N

Format: Chars: a-zA-Z0-9 .,#$()/:?-%+*&;@!~=_' Size: 255

UserDefined3

N

Format: Chars: a-zA-Z0-9 .,#$()/:?-%+*&;@!~=_' Size: 255

UserDefined4

N

Format: Chars: a-zA-Z0-9 .,#$()/:?-%+*&;@!~=_' Size: 255

UserDefined5

N

Format: Chars: a-zA-Z0-9 .,#$()/:?-%+*&;@!~=_' Size: 255

UserDefined6

N

Format: Chars: a-zA-Z0-9 .,#$()/:?-%+*&;@!~=_' Size: 255

UserDefined7

N

Format: Chars: a-zA-Z0-9 .,#$()/:?-%+*&;@!~=_' Size: 255

UserDefined8

N

Format: Chars: a-zA-Z0-9 .,#$()/:?-%+*&;@!~=_' Size: 255

UserDefined9

N

Format: Chars: a-zA-Z0-9 .,#$()/:?-%+*&;@!~=_' Size: 255

UserDefined10

N

Format: Chars: a-zA-Z0-9 .,#$()/:?-%+*&;@!~=_' Size: 255

UserDefined11

N

Format: Chars: a-zA-Z0-9 .,#$()/:?-%+*&;@!~=_' Size: 255

UserDefined12

N

Format: Chars: a-zA-Z0-9 .,#$()/:?-%+*&;@!~=_' Size: 255

UserDefined13

N

Format: Chars: a-zA-Z0-9 .,#$()/:?-%+*&;@!~=_' Size: 255

UserDefined14

N

Format: Chars: a-zA-Z0-9 .,#$()/:?-%+*&;@!~=_' Size: 255

UserDefined15

N

Format: Chars: a-zA-Z0-9 .,#$()/:?-%+*&;@!~=_' Size: 255

UseShippingDetails

Y

Format: Y/N (default)

VerifyByIssuer

Y

Format: Y/N (default)

future

Zip

Y

Format: Numeric, 5

Output Parameters:

Name
Definition
Failure Case
Success Case
Comments

BankRoutingNumber

Format: Alphanumeric, 9

Not returned

Returned

CardHolderState

Format options: V V-PNS RNV NRNV

Not returned

Returned

CardNumber

Format: Numeric, 16

Not returned

Returned

DDA

Format: Numeric, 3-16

Not returned

Returned

OOWEligible

Format: Y/N

Not returned

Returned

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.

Not returned

Returned

VerificationAttempts

Format: Numeric, 2

Not returned

Returned

VerificationID

Format: Alphanumeric, 50

Not returned

Returned

VerificationStatus

Format options: If CH is verified, the options are: VerifiedSSN VerifiedByIssuer If CH is not verified, the options are: SSNVerificationRequired (if DocType is SSN & SkipVerification=Y) DocumentaryVerificationRequired (if DocType is SSN & SkipVerification=N) DocumentaryVerificationRequired (if DocType is not SSN)

Not returned

Returned

CardAvailableBalance

Format: Numeric, 11

Not returned

Returned

RPID

Format: Numeric, 1-19

Not returned

Returned

IVRPhoneNumber

Format: Numeric, 6-15

Not returned

Returned

ProgramURL

Format: Alphanumeric, 1000 (including ? : . )

Not returned

Returned

FeeAmount

Format: Numeric, 10

Not returned

Returned

Fees.Fee tag

ContextTransactionDescription

Format: Alphanumeric, 80

Not returned

Returned

Fees.Fee tag

ContextTransactionType

Format: List of values: Credit, Debit

Not returned

Returned

Fees.Fee tag

FeeAmount

Format: Numeric, 10

Not returned

Returned

Fees.Fee tag

FailedFee

Format: Y/N. Provide yes if there are some fees which are not taken for any reason

Not returned

Returned

Fee tag

XML Samples

Input XML

<?xml version="1.0" ?>
<PraxellXMLRequest>
     <AuthenticationDetails>
	<UserName>hccne_fb_QA</UserName>
	<UserPassword>1q2w3e4r</UserPassword>
      <ClientSourceIP></ClientSourceIP>
 </AuthenticationDetails>
       <ServiceDetails>
	 <ServiceName>InstantIssueCard</ServiceName>
        <UniqueRequestId>5435435436</UniqueRequestId>
    </ServiceDetails>
        <Origin>
            <OriginType>Portal:pdp</OriginType>
        </Origin>
    <ServiceParams>
        <AddressLine1>fail</AddressLine1>
        <AddressLine2></AddressLine2>
        <Amount>10495</Amount>
        <CardNumber></CardNumber>
        <City>sdfsdf</City>
        <Country>US</Country>
        <DateOfBirth>1980-01-01</DateOfBirth>
        <Description></Description>
        <DocExpirationDate></DocExpirationDate>
        <DocId>231231231</DocId>
        <DocIssueDate></DocIssueDate>
        <DocIssuer></DocIssuer>
        <DocType>SSN</DocType>
        <Email></Email>
        <Fax></Fax>
        <FirstName>sdfsdfsdf</FirstName>
        <IsReceiveSms></IsReceiveSms>
        <IssueWithoutVerification>N</IssueWithoutVerification>
        <LastName>sdsdfsdf</LastName>
        <MiddleInitial></MiddleInitial>
        <MobilePhone></MobilePhone>
        <OperationType>CardNumber</OperationType>
        <Phone>2342342234</Phone>
        <RPID></RPID>
        <ShippingAddressLine1></ShippingAddressLine1>
        <ShippingAddressLine2></ShippingAddressLine2>
        <ShippingCity></ShippingCity>
        <ShippingState></ShippingState>
        <ShippingZIP></ShippingZIP>
        <SkipVerification></SkipVerification>
        <State>AL</State>
        <VerifyByIssuer>Y</VerifyByIssuer>
        <UseShippingDetails>234234234</UseShippingDetails>
        <Zip>234234234</Zip>
   </ServiceParams>
</PraxellXMLRequest>
<?xml version="1.0"?>
<PraxellXMLResponse>
     <ResponseDetails>
        <ServiceName>InstantIssueCard</ServiceName>
        <SessionId>38553811201107063</SessionId>
        <StatusCode>0</StatusCode>
        <StatusName>StatusOK</StatusName>
        <StatusDescription>NA</StatusDescription>
        <ServiceDate>2011-06-29 11:07:39</ServiceDate>
        <ServiceId>38553811201107063</ServiceId>
    </ResponseDetails>
<ResponseParams>
    <BankRoutingNumber></BankRoutingNumber>
    <CardNumber></CardNumber>
    <CardHolderState>V-PNS</CardHolderState>
    <DDA></DDA>
    <ProductTypeName></ProductTypeName>
    <VerificationID>9772761</VerificationID>
    <VerificationStatus>VerifiedSSN</VerificationStatus>
    <VerificationAttempts>1</VerificationAttempts>
    <OOWEligible>N</OOWEligible>
    <CardAvailableBalance></CardAvailableBalance>
    <RPID></RPID>
    <IVRPhoneNumber></IVRPhoneNumber>
    <ProgramURL></ProgramURL>
    <Fees>
    <Fee>
    <FeeAmount></FeeAmount>
    <ContextTransactionDescription></ContextTransactionType>
    <ContextTransactionType></ProductTypeName>
    <FeeAmount></FeeAmount>
    </Fee>
    </Fees>
    <Fee>
    <FailedFee></FailedFee>
    </Fee>
    <ProductTypeName></ProductTypeName>
</ResponseParams>
</PraxellXMLResponse>
<?xml version="1.0"?>
<PraxellXMLResponse>
     <ResponseDetails>
        <ServiceName>InstantIssueCard</ServiceName>
        <SessionId>38553811201107063</SessionId>
        <StatusCode>70000</StatusCode>
        <StatusName>Processor error</StatusName>
        <StatusDescription>NA</StatusDescription>
        <ServiceDate>2021-02-23 11:07:39</ServiceDate>
        <ServiceId>38553811201107063</ServiceId>
    </ResponseDetails>
</PraxellXMLResponse>

Last updated