post https://payusandbox-kong.pc.enstage-sas.com/resetPin
The Set/Reset PIN API is used to set or reset the PIN for the card.
Environment
| Sandbox | https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/onboarding/v2/fundTransfer |
| Production | Contact your WIBMO KAM or support. |
Sample request
curl --request POST \
--url https://payusandbox-kong.pc.enstage-sas.com/resetPin \
--header 'X-Consumer-Custom-ID: F42BC4E7B801C834B630DE498473533F' \
--header 'bankId: 6060' \
--header 'clientId: 1060' \
--header 'content-type: application/json' \
--header 'entityId: 100' \
--header 'secureCode: pu8gSMLNE7pNv36IlUmstU' \
--header 'x-api-key: 4A02C4267C9A97A1488AB3259FD1A725' \
--data '
{
"token": "lO+YNouaBSM4g7C+33YxbAIOg5SL053shNBmew7bP2Vwbqa245hIpaJJgaO8Vu2czuOXDo7D4e2S58697mvuapEOXTxZtpV4hLyx56i5kFh6In9X68vnfeDCa1gFBWgFWlHqQTIzIXPo6zHsRcz3QhNIQnI3tDW93vU71zNg1MIglZ9z9htSFF0YbMcfedxgAPgYZlGEI8HUFY9mlChpvBa2c4myBQ3Xr9O2KymfZyRvS0HpbBKL/Cdyxsr8B+rEiaDQb9nITaUA2Kka45xB7w=="
}
'
Response parameters (Decrypted)
This API will provide a token in the response that must be decrypted using the Decrypt API. The decrypted response is similar to the following:
| Parameter | Type | Parameter Requirement | Description |
|---|---|---|---|
| messageCode | numeric(4) | Mandatory | Code to Identify Reset pin response type. |
| clientTxnId | string(100) | Mandatory | Value echoed from the request |
| urn | numeric(11) | Mandatory | Value echoed from the request |
| accosaRefNo | numeric(20) | Mandatory | Auto-generated sequence number. |
| responseDateTime | numeric(14) | Mandatory | Response date time in the format YYYYMMDDHHMMSS with time in 24-hour format |
| customerId | string(20) | Mandatory | Customer ID which uniquely identifies the cardholder in the client system. |
| accosaTransactionId | numeric(10) | Mandatory | Unique ID for a particular transaction/request generated in Prepaid |
| responseCode | string(4) | Mandatory | Represents the status of the transaction. |
| responseMessage | string(100) | Optional | Response message based on the response code. |
| description | string(100) | Optional | Reserved field to send information to the client. |
| bankId | numeric(4) | Mandatory | Value echoed from the request header |
| clientId | String(15) | Mandatory | Value echoed from header |
Sample response (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
}
Error codes
| Error Code | Description |
|---|---|
| 00 | SUCCESS |
| 1001 | CARD NOT FOUND |
| 1016 | ERROR RESET PIN |
| 1031 | INVALID BANK ID |
| 1032 | INVALID CLIENT CHANNEL |
| 1049 | INVALID SECURE CODE |
| 1054 | DUPLICATE REQUEST |
| 1056 | INVALID MESSAGE CODE |
| 1081 | OPERATION NOT ALLOWED |
| 1083 | URN AND LAST 4 DIGITS MISMATCH |
| 1084 | URN AND CUSTOMER ID MISMATCH |
| 1085 | REQUESTOR UNAUTHORIZED FOR URN OR PRODUCT |
| 1088 | INVALID REQUEST DATE format |
| 1093 | INVALID CLIENT TXN ID |
| 1099 | INVALID_PIN |
| 1116 | CARD AML PROFILE MISSING |
| 1302 | INVALID_CUSTOMER |
| 1303 | CUSTOMER DETAILS NOT PRESENT |
| 1304 | MORE THAN ONE CUSTOMER IDENTIFIER NOT ALLOWED |
| 1342 | UNIQUE_IDENTIFIER_REQUIRED_URN_OR_CUSTOMERID |
| 1366 | PROGRAM NOT FOUND |
| 1366 | PROGRAM IS INACTIVE |
| 1367 | PROGRAM_INACTIVE |
| 1367 | PROGRAM NOT FOUND |
| 1500 | SYSTEM ERROR |
| 1501 | SYSTEM ERROR |
| 1502 | SYSTEM ERROR |
| 5003 | CLIENT_NOT_CONFIGURED_UNDER_BANK_ID |
| 9301 | PIN_MISSING |