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"
}
]
}
}
Updated 4 months ago