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
Body
Attribute | Description | Example |
|---|---|---|
Encrypted | ||
token |
| Pl8F5kDZcvADIiursiA |
Decrypted | ||
messageCode |
| 1080 |
clientTxnId |
| GOUd789hhhjfscs |
requestDateTime |
| 20161031214559 |
customerId |
| 11001188721 |
last4Digits |
| 7810 |
urn |
| 70000000008 |
reserved1 |
| Block |
reserved2 |
| Investigating for fraud |
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
Parameter | Description | Sample value |
|---|---|---|
Encrypted | ||
token | Token is the Encrypted body of the below request AES-192-CBC bits Encryption | Pl8F5kDZcvADIiursiAvv |
Decrypted | ||
messageCode | Code to Identify load response type. | 1081 |
clientId | Value copied from the request | 2000 |
clientTxnId | Value copied from the request | GOUd789hhhjfscs |
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 by Prepaid system | 70000000008 |
customerId | Customer Id(entityCIF), which uniquely identifies the cardholder in the client system. | |
Conditional with mobile number and Urn. | 11001188721 | |
accosaTransactionId | Unique ID for a particular transaction generated in Prepaid | 3591893 |
responseCode | Contains the status of the transaction. 00 indicates success. Please refer Appendix for other response codes | 0 |
responseMessage | Response message based on response code will be sent | Success |
description | Reserved field to send information to client | Success |
accosaRefNo | Auto generated sequence number | 123212 |
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
}