Block Card
This API handles requests to block both Debit and Prepaid Cards either through Active Active (Postilion) or Non Active Active(Postcard CMS).
Request Message description
Field # | Field name | Data type | Max length | Required | Description |
---|---|---|---|---|---|
1 | pan | string | 16 to 19 | true | Card Personal Account Number (PAN) |
2 | holdRspCode | string | 2 to 2 | true | Hold Response Code. (Default Codes are 41 for Lost Card, 43 for Stolen Card, 45 for Account Closed and 01 for Refer to Card Issuer.) |
3 | seqNr | string | 3 to 3 | true | Card Sequence Number |
4 | expiryDate | string | 4 to 4 | true | Card Expiry Date |
5 | rid | string | 1 to 11 | false | Receiving Institution Identifier for Postilion |
Request 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 |
POST /card-management/api/v1/card/block
Authorization = Bearer Token
Sample Request
{
"pan": "5060990000000151002",
"holdRspCode": "41",
"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 exists. |
Sample Response (success)
{
"code": "00",
"description": "Successful",
"correlationId": "5daa9a3f6ce9497d84c559aea9f924b3"
}
Sample Response (failure)
{
"code": "400",
"description": "Unsuccessful",
"correlationId": "d5c294c81e904a21b3847a5f2b91de44",
"errors": [
{
"message": "File Update error - Card Lookup Failed",
"fieldName": "27 - P003"
}
]
}
Updated 6 months ago