Link Card To Account

To link a card to an account successfully, make a POST Request to the link card account endpoint.

POST /card-management/api/v1/card/linkAccount

Query Parameters description

Parameter #Parameter NameData TypeRequiredDescription
1isActiveActivebooleantruetrue - request is routed through Postilion Service

false - request is routed through 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

Body Parameters

Field #Field nameData typeMax lengthRequiredDescription
1panstring16 to 19trueCard Personal Account Number (PAN)
2seqNrstring3 to 3trueCard Sequence Number
3expiryDatestring4 to 4trueCard Expiry Date
4issuerNrint3trueIssuer Number
5userIdstring3 to 20trueUser ID or Name
6accountIdstring10 to 28trueAccount ID or Number
7accountTypestring2 to 2trueAccount Type
8ridstring1 to 11falseReceiving Institution Identifier for Postilion

This is what a typical request would look like

  "pan": "5061800000000000363",
  "accountId": "0123456789",
  "accountType": "20",
  "userId": "Alex",
  "issuerNr": "2",
  "seqNr": "001",
  "expiryDate": "5004"

Response Message  field description

Field #Field nameDescription
1codeInternal Response Code
2descriptionSuccessful or Error Message
3correlationIdRequest identifier
4errorsErrors array if any errors exist.

This is what a typical successful or failed response would look like

  "code": "00",
  "description": "Successful",
  "correlationId": "5daa9a3f6ce9497d84c559aea9f924b3"
  "code": "400",
  "description": "Unsuccessful",
  "correlationId": "d5c294c81e904a21b3847a5f2b91de44",
  "errors": [
      "message": "File Update error - Card Lookup Failed",
      "fieldName": "27 - P003"