Unblock Card API is called by the client to Unblock the card in case of card is in the blocked state. Using this API, temporary and custom blocked cards can be unblocked, whereas permanent block cannot be unblocked.
Environment: https://domain/mob1/api/onboarding /v1/unblock
HTTP Method: PATCH
Note:
The domain will be shared once this move to respective environment.
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
Sample request
Packet sample (Encrypted)
{
“token”: “h/0YSUdGzgNsMcmfYAvIIPgF3Z80/kMJkW/7l9wG9L+bXt//P/HBG0NsuoPtbn6ugjzNOLl/wQPJFbCKMqQJtSSQs4JVYBohia1TPP1yJULHN+TLIVKFRZsg0GokTPI+ZKpNPcrKrQSa70qV/RtVWMv6CmqRHaG1gQvgAYKjNyOpip7G3Io5IDEF4b2cXOlH4G1hbOtjAHQ/7ZS9KrkmJA==”
}
Packet sample (Decrypted)
{
"messageCode": "1072", "requestDateTime": "20161221210608", "clientTxnId": "ccccfccs",
"last4Digits": "0930",
"urn": 70000000008,
"customerId": "QW149",
"fromDate":"08/06/2015", "toDate": "30/06/2019", "pageNumber":"1", "count":"10", "fromRowId":"0"
}
Response parameters
API error code
| 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 |
| 1067 | CARD ALREADY UNBLOCKED |
| 1231 | DATA_NOT_FOUND |
| 1237 | DUPLICATE_PHONE_NUMBER_WITH_MULTIPLE_ACCOUNT |
| 1356 | CARD_NOT_ACTIVE |
| 1366 | PROGRAM IS INACTIVE |
HTTP status code
| HTTP Status Code | HTTP Status Description |
|---|---|
| 200 | OK |
| 404 | Not Found |
| 500 | Internal Server Error |
| 403 | Forbidden |
| 400 | Bad Request |
| 401 | Unauthorized |
| 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": "IN00001201001865", "description": "UnBlocking", "responseCode": "00",
"messageCode": "1251",
"clientTxnId": "CUBL-456",
"clientId": "2000",
"responseDateTime": "20160715025837", "accosaTransactionId": 1024, "responseMessage": "Success", "accosaRefNo": "6007283",
"bankId": 7000
}