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 nameData typeMax lengthRequiredDescription
1panstring16 to 19trueCard Personal Account Number (PAN)
2holdRspCodestring2 to 2trueHold Response Code. (Default Codes are 41 for Lost Card, 43 for Stolen Card, 45 for Account Closed and 01 for Refer to Card Issuer.)
3seqNrstring3 to 3trueCard Sequence Number
4expiryDatestring4 to 4trueCard Expiry Date
5ridstring1 to 11falseReceiving Institution Identifier for Postilion

Request 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
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 nameDescription
1codeInternal Response Code
2descriptionSuccessful or Error Message
3correlationIdRequest identifier
4errorsErrors 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"
    }
  ]
}