Change Card PIN
This API handles requests to change card PIN.
Request Message description
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 |
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/changePin
Authorization = Bearer Token
Sample Request
{
"pan": "5060990000000151002",
"seqNr": "001",
"expiryDate": "5004",
"pin": "3a6938700f7f4587ffb326c184b609c342da5e1fef0dcf77e45f7b17319682916a1bbd337cd356f2ee41c3c09bd92159feb85ecdf45f4b7a831cb57fabd0d3e90b59cc8d10d384a7ad6450700eb0bd7f0172660b7a6cc15ec40b2cdc2e0a738c5457c76ee2247eb1e0d7f01ee88ab7c8fb9e5ca1f8b36d115742270c0af66d38e45940101d812e2aa64979d52fe6a180a390a77fb21b0e94cc12ff9a83559ab7fd879238eec65e5b2ee5d4a9f9834c341a1fe0f121947485a14e1c9b70edf79544a9953a573ddf15d7ec447f356227249f01726f9cc61407f6f057d90a8c4f2c8dbe344989c10a4e6f26299122591269d025fb4e5a40b316d7ede0b1e60e5e81",
"accountType": "20",
"userId": "Alex",
"oldPin": "3a6938700f7f4587ffb326c184b609c342da5e1fef0dcf77e45f7b17319682916a1bbd337cd356f2ee41c3c09bd92159feb85ecdf45f4b7a831cb57fabd0d3e90b59cc8d10d384a7ad6450700eb0bd7f0172660b7a6cc15ec40b2cdc2e0a738c5457c76ee2247eb1e0d7f01ee88ab7c8fb9e5ca1f8b36d115742270c0af66d38e45940101d812e2aa64979d52fe6a180a390a77fb21b0e94cc12ff9a83559ab7fd879238eec65e5b2ee5d4a9f9834c341a1fe0f121947485a14e1c9b70edf79544a9953a573ddf15d7ec447f356227249f01726f9cc61407f6f057d90a8c4f2c8dbe344989c10a4e6f26299122591269d025fb4e5a40b316d7ede0b1e60e5e81",
"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 exists. |
Sample Response (success)
{
"code": "00",
"description": "Successful",
"correlationId": "5daa9a3f6ce9497d84c559aea9f924b3"
}
Sample Response (failure)
{
"code": "10404",
"description": "No result found",
"correlationId": "2aa197eda43540a4ad85b8d0bf570871"
}
Updated 7 months ago