Reissue Card PIN

This API handles requests to reissue card PIN.


Request Message description

Field #Field nameData typeMax lengthRequiredDescription
1issuerNrint3trueIssuer Number e.g 2
2userIdstring3 to 20trueUser Id or Name e.g Alex
3panstring16 to 19trueCard Personal Account Number (PAN)
4seqNrstring3 to 3trueCard Sequence Number
5expiryDatestring4 to 4trueCard Expiry Date
6customerIdstring25falseCustomer ID
7mobileNrstringfalseCustomer Mobile Number

ParameterParameter NameData TypeRequiredDescription
1isActiveActivebooleanFalsetrue - card is generated from postcard cms but issued through postilion service. Default value when not provided.

false - card is generated and issued by the 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/reissue-pin?isActiveActive=true
Authorization = Bearer Token

Sample Request

{
  "issuerNr": 2,
  "pan": "5060990000000151002",
  "seqNr": "001",
  "expiryDate": "5004",
  "customerId": "20220728132321467651002",
  "mobileNr": "08033344455",
  "userId": "Alex"
}

Response Message  field description


Field #Field nameDescription
1codeInternal Response Code
2descriptionSuccessful or Error Message
3correlationIdRequest identifier
4errorsErrors array if any errors exists.
5pinNew Pin Encrypted using an RSA Public Key provided by the Client
6pinOffsetPin Offset

Sample Response (success)

{
    "code": "00",
    "description": "Successful",
    "correlationId": "fbfcb56fbd734e91923e235238637eaf",
    "pin": "697015692a448309e96a550d4d234d074dafd5dab92734a60f498be83237a22c995f713996864615c9798a75a166d1d9e62f7838719e3a33ab3fccd54856bd25a4e0933743e7ade61707b25fcb11c0ca6050bfdd66a4c8d276c52ce203b83f0834cec4e3292d6345f0721f7534fa816003d445f6f5dac714c5ca9ec4b6ea43cb5d875de4e778086843a7fe4dade1f21f04cda8e82550434efc1ec529c5ba2e1962406f452036d184f15785427c6948c360d949064eb22f3844dd9f0e74590926eaae6c26316cea1690cd4ee3ced0d625226430fed0fde9fe3ffe07200ee2b4d253f2efcad06c86bf14cde613474e5730ec8e9ea76fece99aa70fa6c286eda8a8",
    "pinOffset": "6192"
}

Sample Response (failure)

{
  "code": "10404",
  "description": "No result found",
  "correlationId": "2aa197eda43540a4ad85b8d0bf570871"
}
{
    "code": "400",
    "description": "Unable to encrypt pin for response",
    "correlationId": "5c538970ea8b48959086dca8727be8a5"
}
{
    "code": "404",
    "description": "Client Config with Client ID: xxx not found",
    "correlationId": "5c538970ea8b48959086dca8727be8a5"
}