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 Name	Data Type	Required	Description
1	isActiveActive	boolean	true	true - 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 name	Data type	Max length	Required	Description
1	pan	string	16 to 19	true	Card Personal Account Number (PAN)
2	seqNr	string	3 to 3	true	Card Sequence Number
3	expiryDate	string	4 to 4	true	Card Expiry Date
4	issuerNr	int	3	true	Issuer Number
5	userId	string	3 to 20	true	User ID or Name
6	accountId	string	10 to 28	true	Account ID or Number
7	accountType	string	2 to 2	true	Account Type
8	rid	string	1 to 11	false	Receiving 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 name	Description
1	code	Internal Response Code
2	description	Successful or Error Message
3	correlationId	Request identifier
4	errors	Errors 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"
    }
  ]
}
}