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
<WalletHeader />
Body
Note:
Encryption or decryption methodology is AES-192-CBC bits encryption.
Parameter | Description | Example |
---|---|---|
Encrypted | ||
token |
| Pl8F5kDZcvADIiursiA |
Decrypted | ||
messageCode |
Character Limit - 4
| GOUd789hhhjfscs |
requestDateTime |
| 20161031214559 |
last4Digits |
| 4664 |
urn |
| 70000000008 |
newPIN |
| 123456 |
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
Parameter | Description | Example |
---|---|---|
Encrypted | ||
token | Token is the Encrypted body of the below request AES-192-CBC bits Encryption | Pl8F5kDZcvADIiursiAvvbHNuL9Wv5eaFdorGVFU6FKfIEnV/YskkzJlAov2ZHJWnqGNLOXfBq4SQqw8Ep4sK0gCAAkRXATCb1nSY6s= |
Decrypted | ||
messageCode | Code to Identity create card response type | 1011 |
clientId | Unique ID for client | 2000 |
clientTxnId | Value copied from the request | 20150701235959xhstiesqfds |
bankId | Value copied from the request | 7000 |
responseDateTime | Response date time in the format YYYYMMDDHHMMSS with time in 24 hr format | 20161031214559 |
urn | A unique reference number for the generated card/wallet by Prepaid system | 70000000008 |
customerId | Customer Id (entityCIF), which uniquely identifies the | IN2016201611 |
accosaTransactionId | Unique id for a particular transaction generated in Prepaid | 3591893 |
responseCode | Contains the status of the transaction. 201 indicates CREATED. Please refer Appendix for other response codes | 201 |
responseMessage | Response message based on response code will be sent | Card creation successful |
description | Reserved field to send information to client | Card Creation response |
accosaRefNo | Auto generated sequence number. | 4565166 |
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
}