Create Single Card

This API handles single card production either through Postcard CMS or Postilion Service. It also allows creation of debit cards on new accounts, debit cards on existing accounts, reissuing debit cards, new prepaid cards and reissuing existing prepaid cards. If Pregenerated PAN is provided in the request, the service will attempt to create the card using the provided PAN. However, If PAN is not provided, Postcard CMS will automatically generate a Card PAN to create the card. The endpoint also allows creation of anonymous cards without providing required customer specific details. These anonymous cards will be created with following default values against the required fields.

Request Message description

Field #Field nameData typeMax lengthRequiredDescription
1issuerNrint3trueIssuer Number e.g 2
2cardProgramstring1 to 20trueCard Program e.g VERVE
3userIdstring3 to 20trueUser Id or Name e.g Alex
4accountIdstring10 to 28false/trueRequired for All Debit Card Types
5accountTypestring2 to 2false/trueRequired for All Debit Card Types
6lastNamestring30false/trueRequired for New Debit and Prepaid Cards
7firstNamestring30false/trueRequired for New Debit and Prepaid Cards
8nameOnCardstring25false/trueRequired for New Debit and Prepaid Cards
9panstring16 to 19false/trueRequired for Reissue Debit and Prepaid Cards
10lostOrStolenbooleantrue or falsefalse/trueRequired for Reissue Debit and Prepaid Cards
11pinstring4falseDefault is 1234 when not provided
13customerIdstring25falseCustomer ID is autogenerated when not provided
14mobileNrstring50falseCustomer Mobile Number
15emailAddressstring70falseCustomer Email Address
16streetAddressstring100falseStreet Address
17streetAddressLine2string100falseStreet Address Line 2
20postalCodestring20falsePostal Code
21countryCodestring3falseCountry Code
22titlestring10falseCustomer Title e.g Mr.
23middleNamestring30falseCustomer Middle Name
24dateOfBirthstring8 to 8falseDate of Birth in format YYYYMMDD e.g 19810130
25ridstring1 to 11falseReceiving Institution Identifier for Postilion

Request Parameters description

Parameter #Parameter NameData TypeRequiredDescription
2isActiveActive**booleanfalsetrue - card is generated from postcard cms but issued through postilion service. Default value when not provided.

false - card is generated and issued by the postcard cms.

** If the application is configured to restrict non active active requests, the value provided by the client may be overridden by the system and set to true
3isAnonymousbooleanfalsetrue - creates anonymous card without any customer specific details. Account Id, Account Type, First Name, Last Name, Name On Card are not required.

false - customer is linked to the card and all required fields must be provided.

Anonymous Card Required Field Default Values

An anonymous card can be created and then later assigned to a customer. To create an anonymous card the isAnonymous parameter must be set to true. This will enable the application to set the following fields to their corresponding default values if they have not been set in the request.

Field #Field nameData typeMax lengthDefaultDescription
1accountIdstring10 to 28666666666666666Required for All Debit Card Types
2accountTypestring2 to 220Required for All Debit Card Types
3lastNamestring30AnonymousRequired for New Debit and Prepaid Cards
4firstNamestring30AnonymousRequired for New Debit and Prepaid Cards
5nameOnCardstring25AnonymousRequired for New Debit and Prepaid Cards
6customerIdstring2520220524081136189680261Required for Reissue Debit and Prepaid Cards
POST /card-management/api/v1/card/request?isActiveActive=false&cardType=DEBIT_EXISTING_ACCOUNT
Authorization = Bearer Token

Sample Request

    "issuerNr" : "1",
    "cardProgram" : "Suntrust_Verve",
    "userId" : "Alex",
    "pin" : "1234",
    "branchCode" : "10010",
    "accountId" : "1234567853",
    "accountType" : "20",
    "lastName" : "Test",
    "firstName" : "Test",
    "nameOnCard" : "Test"

Response Message  field description

Field #Field nameDescription
1codeInternal Response Code
2descriptionSuccessful or Error Message
3correlationIdRequest identifier
4cardCard details if the card request is successful
5successfulif true, card has been generated and issued successfully.

else card may have been generated but not issued successfully

(card request on Postilion might have failed)
6errorsErrors array if any errors exists.

Sample Response (success)

    "code": "00",
    "description": "Successful",
    "correlationId": "2f6b1ebb444845a0b896fefab2fb254b",
    "card": {
        "pan": "5061800000000000389",
        "seqNr": "001",
        "expiryDate": "2508",
        "pinOffset": "7183",
        "cvv": "902",
        "cvv2": "840",
        "pinInfo": "3DD636885F8CBAA5",
        "track2": "5061800000000000389=2508101007183902",
        "customerId": "20220811144303279780389"
    "successful": true

Sample Response (failure)

    "code": "10409",
    "description": "Account already exists.",
    "correlationId": "ff5c14d25d4e4c06aacadcb17f2beea1",
    "successful": false