patch https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/onboarding/v3/unblock
The Unblock Card API is used to unblock the card in case the card is in a blocked state.
Note:
You can unblock through temporary and custom blocked cards, whereas permanent cards cannot be unblocked.
Environment
| Sandbox | https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/onboarding/v3/unblock |
| Production | Contact your WIBMO KAM or support. |
Sample request
curl --request PATCH \
--url https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/onboarding/v3/unblock \
--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": "x0GdeGzqIanem8rPQkUUGuKk400iN5kNFFbGvSAJQHnWVnKgeVEbULSTVk+c/8rcpL0EhV2OgJZCVSzGa6qB4qE6buK2OCnMvyO+MUyRqChDm1NsF6PbzawAFYUYrZcRJ2FN7yqgy0gPI7Q+8qivXTt2WRijv/l1KJo/FudKX/jPx+IlqJcVKQ1+/OaHtrJki5Zo8XNq+ZPeq1vIMWfYJlx2ZJs9qFc/+ZuGqIY5Ls0tQs9+ZXfXCqVQtWG0xBin0DepJRLx3XI8vxx+gHTLJG0duiqIlJe0VcrLlHRcFb66MmaydPEeDOdnIvLO8GPjzNqeG89KbhoN9Y7B5tDZiXZwAHPBd8+8zHa2prZJ0HItuaJiYR6GThaaBUzKr11P"
}
'
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:
| Attribute | Type | Parameter Requirement | Description |
|---|---|---|---|
| messageCode | Numeric(4) | Mandatory | API Unique IDentifier. |
| clientId | String(15) | Mandatory | Value echoed from the request |
| clientTxnId | String(100) | Mandatory | Value echoed from the request |
| bankId | Numeric(4) | Mandatory | Value echoed from the request |
| responseDateTime | Numeric(14) | Mandatory | Response date time in the format YYYYMMDDHHMMSS with time in 24-hour format |
| urn | Numeric(11) | Mandatory | A unique reference number for the card(urn) |
| 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 generated in Prepaid |
| responseCode | String(4) | Mandatory | Represents the status of the transaction. |
| responseMessage | String(100) | Optional | Represents the status of the transaction. |
| description | String(100) | Optional | Reserved field to send information to client. |
| accosaRefNo | Numeric(20) | Mandatory | Auto-generated sequence number. |
Sample response (Decrypted)
{
"urn": 1000000,
"customerId": "IN00001201001865",
"description": "UnBlocking",
"responseCode": "00",
"messageCode": "1251",
"clientTxnId": "CUBL-456",
"clientId": "2030",
"responseDateTime": "20160715025837",
"accosaTransactionId": 1024,
"responseMessage": "Success",
"accosaRefNo": "6007283",
"bankId": 7030
}
Error codes
| Error Code | Description |
|---|---|
| 00 | SUCCESS |
| 1001 | CARD NOT FOUND |
| 1009 | CARD CANCELLED CLOSED EXPIRED |
| 1011 | CARD PERMANENT BLOCK |
| 1012 | CARD PENDING CANCELLATION |
| 1030 | INVALID MESSAGE |
| 1034 | INVALID_MOBILE_NUMBER |
| 1045 | UNABLE TO PROCESS REQUEST |
| 1054 | DUPLICATE REQUEST |
| 1067 | CARD ALREADY UNBLOCKED |
| 1084 | URN AND CUSTOMER ID MISMATCH |
| 1231 | DATA_NOT_FOUND |
| 1237 | DUPLICATE_PHONE_NUMBER_WITH_MULTIPLE_ACCOUNT |
| 1356 | CARD_NOT_ACTIVE |
| 1366 | PROGRAM IS INACTIVE |