Change Card Pin

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

POST /card-management/api/v1/card/changePin

These are the parameters of the request:

Query Parameters

Parameter #	Parameter Name	Data Type	Required	Description
1	isActiveActive	boolean	true	True: Select this option when you want to create a backup for the card. False: Select this option when you don't want a backup.

Body Parameters

📘
Pin Encryption
To change a PIN, you will need to encrypt both the old PIN and the new PIN you wish to use. To learn more about PIN encryption, please follow the link here.

Field #	Field name	Data type	Max length	Required	Description
1	pin	string	4	true	New PIN for the Card in Encrypted Form. Actual PIN Value can only contain digits and have a length of 4.
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	accountType	string	2 to 2	true	Card Account Type
7	oldPin	string	4	false/true	Current PIN for the Card in Encrypted Form. Actual PIN Value can only contain digits and have a length of 4. (required for active active)
8	cvv2	string	3 to 3	false/true	Card CVV2 (required for some cards)
9	rid	string	1 to 11	false	Receiving Institution Identifier for Postilion

This is what a typical request would look like

{
  "pan": "5060990000000151002",
  "seqNr": "001",
  "expiryDate": "5004",
  "pin": "3a6938700f7f4587ffb326c184b609c342da5e1fef0dcf77e45f7b17319682916a1bbd337cd356f2ee41c3c09bd92159feb85ecdf45f4b7a831cb57fabd0d3e90b59cc8d10d384a7ad6450700eb0bd7f0172660b7a6cc15ec40b2cdc2e0a738c5457c76ee2247eb1e0d7f01ee88ab7c8fb9e5ca1f8b36d115742270c0af66d38e45940101d812e2aa64979d52fe6a180a390a77fb21b0e94cc12ff9a83559ab7fd879238eec65e5b2ee5d4a9f9834c341a1fe0f121947485a14e1c9b70edf79544a9953a573ddf15d7ec447f356227249f01726f9cc61407f6f057d90a8c4f2c8dbe344989c10a4e6f26299122591269d025fb4e5a40b316d7ede0b1e60e5e81",
  "oldPin": "3a6938700f7f4587ffb326c184b609c342da5e1fef0dcf77e45f7b17319682916a1bbd337cd356f2ee41c3c09bd92159feb85ecdf45f4b7a831cb57fabd0d3e90b59cc8d10d384a7ad6450700eb0bd7f0172660b7a6cc15ec40b2cdc2e0a738c5457c76ee2247eb1e0d7f01ee88ab7c8fb9e5ca1f8b36d115742270c0af66d38e45940101d812e2aa64979d52fe6a180a390a77fb21b0e94cc12ff9a83559ab7fd879238eec65e5b2ee5d4a9f9834c341a1fe0f121947485a14e1c9b70edf79544a9953a573ddf15d7ec447f356227249f01726f9cc61407f6f057d90a8c4f2c8dbe344989c10a4e6f26299122591269d025fb4e5a40b316d7ede0b1e60e5e81",
  "accountType": "20",
  "userId": "Alex",
  "cvv2": "123"
}

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": "10404",
  "description": "No result found",
  "correlationId": "2aa197eda43540a4ad85b8d0bf570871"
}

Change Card Pin

📘Pin Encryption

📘
Pin Encryption