The Reset PIN API is called by the client if a cardholder forgot his existing PIN and wants to reset the PIN. Before resetting the PIN, client needs to validate the card details.
Environment: https://domain/mob1/api/onboarding/v1/resetPin
HTTP Method: POST
Request parameters
Header
| Parameter | Description | Example |
|---|---|---|
| x-api-key mandatory | String This is a unique key. | 7fe1c0de |
| clientId mandatory | String Uniquely identifies the client. During program enrolment each client is provided with a unique client id by Prepaid | 2000 |
| bankId mandatory | Numeric Bank Id is provided by Prepaid Aero during program enrolment to uniquely identify the card issuer. | 7000 |
| entityId mandatory | Numeric Defaults to parent branch i.e., 100 | 100 |
| secureCode mandatory | String Uniquely identifies the client on payload level for performing operations. | AfYtlO5kqdySIjXyNmGg3F |
Body
Note:
Encryption or decryption methodology is AES-192-CBC bits encryption.
Sample request
Packet sample (Encrypted)
{
“token”: “h/0YSUdGzgNsMcmfYAvIIPgF3Z80/kMJkW/7l9wG9L+bXt//P/HBG0NsuoPtbn6ugjzNOLl/wQPJFbCKMqQJtSSQs4JVYBohia1TPP1yJULHN+TLIVKFRZsg0GokTPI+ZKpNPcrKrQSa70qV/RtVWMv6CmqRHaG1gQvgAYKjNyOpip7G3Io5IDEF4b2cXOlH4G1hbOtjAHQ/7ZS9KrkmJA==”
Packet sample (Decrypted)
{
"messageCode": "1120",
"requestDateTime": "20160715025837",
"clientTxnId": "201507271458370149gM90jY0",
"newPIN": "121200",
"urn": 70000000008,
"last4Digits": "1745",
"customerId": "IN00001201001868"
}
Response parameters
API error codes
| Error Code | Description |
|---|---|
| 0 | SUCCESS |
| 1034 | INVALID_MOBILE_NUMBER |
| 1088 | INVALID_DATE_FORMAT |
| 1090 | CARD_PROFILEID_MANDATORY |
| 1091 | INVALID_CARDPROFILE_ID |
| 1092 | INVALID_EMAIL_ADDRESS |
| 1231 | DATA_NOT_FOUND |
| 1237 | DUPLICATE_MOBILE_NUMBER_WITH_MULTIPLE_ACCOUNT |
| 1306 | PROFILE_NOTFOUND |
| 1309 | CARDPROFILE_MISTMATCH |
HTTP status code
| HTTP Status Code | HTTP Status Description |
|---|---|
| 200 | OK |
| 400 | Bad Request |
| 401 | Unauthorized |
| 500 | Internal Server Error |
| 403 | Forbidden |
| 404 | Not Found |
| 503 | Service Unavailable |
Sample response
Packet sample (Encrypted)
{
“token”: “h/0YSUdGzgNsMcmfYAvIIPgF3Z80/kMJkW/7l9wG9L+bXt//P/HBG0NsuoPtbn6ugjzNOLl/wQPJFbCKMqQJtSSQs4JVYBohia1TPP1yJULHN+TLIVKFRZsg0GokTPI+ZKpNPcrKrQSa70qV/RtVWMv6CmqRHaG1gQvgAYKjNyOpip7G3Io5IDEF4b2cXOlH4G1hbOtjAHQ/7ZS9KrkmJA==”}
Packet sample (Decrypted)
{
"urn": 70000000008,
"customerId": "IN00001201001868",
"description": "Reset Pin",
"responseCode": "00",
"messageCode": "1121",
"clientTxnId": "201507271458370149gM90jY0",
"clientId": "2000",
"responseDateTime": "20160715025837",
"accosaTransactionId": 1031,
"responseMessage": "Success",
"accosaRefNo": "6007283",
"bankId": 7000
}