This API is used to send statements on requests initiated through IVR to customers. The Credit+ Issuing system receives, validates and processes the request. If the request fails, the system returns the corresponding error code in the response and the entry for batch is not logged in system. The statement will be generated based on provided date parameters. However, if only one date parameter is provided, that is either from date or to date, then the latest month’s statement will be generated. If the statement is not generated for the current month, the request fails, and an error message is returned in response. It is applicable for credit and prepaid product issued on Pine Labs platform. This API is also applicable for Static Virtual Active primary devices.
NOTE: This API is applicable for e-mail statement mode only. This API is used for the same purposes as ‘Statement Request on IVR API (V1)’. However, this API is encrypted and has additional request and response attributes. Further this API, ifsent with Card Number Alias (CNA), will fetch the corresponding associated device for further processing only if DEVICE _STATUS_CODE = NORMAL (0) OR (DEVICE_STATUS_CODE = UPGRADE (9) AND UPGRADE_STATUS = 1).
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 | CCRBO0004 | Request processed successfully. |
| 400 | 997 | Form Factor Type field is mandatory. |
| 400 | 997 | Invalid Form Factor Type. |
| 400 | 997 | Form Factor field value must have min length 10. |
| 400 | 997 | Form Factor field is mandatory. |
| 400 | 997 | Form Factor field value must have max length 24. |
| 400 | 997 | One of the Dates not provided correctly. |
| 400 | 997 | Statement Period From must be in ddMMyyyy format. |
| 400 | 997 | Statement Period From field is mandatory. |
| 400 | 997 | Statement Period To must be in ddMMyyyy format. |
| 400 | 997 | Statement Mode field is mandatory. |
| 400 | 997 | Invalid Statement Mode. |
| 400 | 997 | Invalid Priority Request. |
| 400 | 997 | At least one transaction channel required. |
| 400 | VALFRM003 | Invalid Device. |
| 400 | VALFRM004 | Invalid Device. |
| 400 | VALFRM005 | Invalid Card Pack Id. |
| 400 | VALFRM007 | Invalid form factor type. |
| 400 | VALFRM015 | Statement request not allowed for Debit product. |
| 400 | STMREQ011 | Preferred address not present. |
| 400 | STMREQ010 | Email-id not present. |
| 400 | STMREQ007 | Statement Period To is mandatory for Prepaid device. |
| 400 | STMREQ005 | Statement Period To not allowed for credit device. |
| 400 | STMREQ003 | Statement not generated for the given period. |
| 400 | STMREQ009 | Error while statement log req. |
| 400 | STMREQ000 | Request Processed Successfully. |
| 201 | HDS000 | Request processed successfully. |
| 400 | HDE192 | Statement for specified date range not available. |
| 500 | HDE105 | Error Occurred as Value not specified for Statement By. |
| 500 | HDE107 | Error Occurred as Email ID not specified. |
| 500 | HDE108 | Error in fetching Email ID from Device. |
| 400 | HDE109 | Error Occurred as Email ID not specified in Device table. |
| 400 | HDE110 | Error Occurred as Email ID is not matching with Device Email ID. |
| 500 | HDE111 | Error Occurred while generating statement. |
| 500 | HDE112 | Error Occurred while generating statement fees. |
| 500 | HDE113 | Error Occurred while generating statement. |
| 400 | 997 | Program Code field should only contain [A-Z 0-9] and underscore and must start and end with alphanumeric character. |
| 400 | 997 | Device Plan Code field should only contain [A-Z 0-9] and underscore and must start and end with alphanumeric character. |
| 400 | 997 | Product Type field is invalid. |
| 400 | 997 | Only alphanumeric characters and underscore are allowed. |
| 400 | 997 | FORM_FACTOR field value must have max length 24. |
| 400 | CNA006 | Multiple device numbers are active for given details. |
| 400 | CNA002 | Card Number Alias Functionality is not applicable for this Institution. |
| 400 | CNA003 | Record does not exists for the given details. |
| 400 | CNA001 | Bank Does Not Exists. |
| 400 | 994 | Invalid Encryption-Algorithm header value. |
| 400 | 994 | Invalid Encryption Request Parameters. |
| 400 | 994 | Cryptography error. |