This API is used to activate or deactivate the e-commerce transactionsfor the particular device. It is applicable for prepaid, credit and debit products issued on Pine Labs platform. The Credit+ Issuing receives, validates, and processes the request. If the request is successful, the device usage is allowed or restricted on the card. The system then logs the Device Usage Control (service code: 454) service request (SR) and sends the service request details in the response message. In the case of API channel, the SR is processed immediately irrespective of whether the checker/maker configuration is enabled for this SR or not. If the request fails, the system returns the corresponding error code in the response and the SR is not logged.
HTTP Status and Response Status Matrix
-
HTTP Code: This is the response status code issued by a server in response to a client's request made to the server.
-
Error Code: This is the error code returned by Credit+ Issuing application in the ‘code’ field of the response message indicating if the request was processed successfully or failed.
-
Reason: This is the description of the error code returned by Credit+ Issuing application.
| HTTP Code | Error Code | Reason |
|---|---|---|
| 201 | 000 | Success. |
| 400 | 997 | Bad Request. |
| 401 | 900 | User Or Bank does not support API. |
| 404 | 998 | Invalid Device. |
| 500 | 999 | Error while processing request. |
| 408 | 912 | Forward offset time limit violated. |
| 408 | 913 | Backward offset time limit violated. |
| 500 | 951 | System Internal Error. |
| 408 | 902 | Invalid Transaction. |
| 403 | 909 | System Malfunction. |
| 404 | 914 | Original Transaction not Found. |
| 500 | EAD001 | Either invalid device or device status code not normal. |
| 500 | EAD002 | Invalid device. |
| 500 | EAD003 | Device number not found. |
| 500 | EAD004 | Invalid Card pack id. |
| 500 | EAD005 | Invalid form factor type. |
| 500 | EAD006 | Device is not in normal state. |
| 500 | GETDEV004 | Error while fetching device number. |
| 400 | ECOM002 | Date entered for fromdate and todate should not be less than institution business date. |
| 500 | CNA001 | Bank Does Not Exists. |
| 500 | CNA003 | Record does not exists for the given details. |
| 500 | CNA005 | Multiple device numbers are linked for given details. |
| 500 | CNA006 | Error while fetching device details. |
| 500 | CNA002 | Card Number Alias Functionality is not applicable for this Institution. |
| 500 | HDE006 | Invalid device. |
| 500 | HDE409 | Device is not normal. |
| 500 | HDE305 | Invalid Program code. |
| 500 | HDE259 | DEVICE is already de-activated. |
| 500 | HDE260 | DEVICE is already activated for life long use. |
| 500 | HDE261 | DEVICE is already activated for N hours. |
| 500 | HDE265 | DEVICE is already activated for a specific period. |
| 500 | HDE264 | Only Activated DEVICE can be De-Activate. |
| 500 | EAD001 | Either invalid device or device status code not normal. |
| 500 | EAD002 | Invalid device. |
| 500 | EAD003 | Device number not found. |
| 400 | 994 | Invalid Encryption-Algorithm header value. |
| 400 | 994 | Invalid Encryption Request Parameters. |
| 400 | 994 | Cryptography error. |