Re-Issue Card Pin

The card API provides you with the functionality to re-issue the pin of a card.

Re-Issue Card Pin

This endpoint handles requests to re-issue card PINs. To re-issue a card pin successfully, make a POST Request to the re-issue card pin endpoint .

/card-management/api/v1/card/reissue-pin

These are the parameters of the request:

Body Parameters

Field #	Field name	Data type	Max length	Required	Description
1	issuerNr	int	3	true	Issuer Number e.g 2
2	userId	string	3 to 20	true	User ID or Name e.g Alex
3	pan	string	16 to 19	true	Card Personal Account Number (PAN)
4	seqNr	string	3 to 3	true	Card Sequence Number
5	expiryDate	string	4 to 4	true	Card Expiry Date
6	customerId	string	25	false	Customer ID
7	mobileNr	string		false	Customer Mobile Number

This is what a typical request would look like:

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

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.
5	pin	New Pin Encrypted using an RSA Public Key provided by the Client
6	pinOffset	Pin Offset

This is what a successful response will look like :

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

Sample failed responses :

{
  "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"
}