This API is used to get the mini statement. This API is used for the same purposes as ‘Mini statementfor Prepaid card and Credit card API (V1)’. However, this API has additional response attribute(s). Depending on the request, the system validates the following details:The system verifies if the Allow Mini Statement API flag is selected for the current status of the device used, on the Card Management> Institution Parameter Setup> Device Status screen. • If the flag is enabled and the request is a financial request, the request is processed according to the response code of the device status. • If the response code is in approved stage, the request is processed further. • If the value of DEVICE_STATUS_CODE = UPGRADE (9) AND UPGRADE_STATUS = 1 for a financial transaction, the request is approved irrespective of the response code for program change status. • If the value of DEVICE_STATUS_CODE = UPGRADE (9) AND UPGRADE_STATUS = 2 for a financial transaction, the request is processed according to the response code of the device status. • If the account is in Freeze status and fee is not applicable, and the Allow Mini Statement API flag is selected in the Device Status screen, the API request is processed successfully. • If the account isin Freeze status and fee is applicable, the API request is not processed. An error message 'Transaction not permitted' is displayed.
Card Number Alias (CNA) processing logic- Institution level uniqueness
- If the system locates a device with status code as Normal (0) or Upgrade (9 with upgrade status as 1), then that device is used for processing the request.
- If the system locates two devices; one with status code as Normal (0) and another with status code as Upgrade (9 with upgrade status as 1), and both have the same client ID, then the device with status code as Upgrade isselected and the request is processed on that device.
- If the CNA is linked to multiple devices with status code as Normal (0) or Upgrade (9 with upgrade status as 1), the request is rejected.
- If the system does not find any device with status code as per step 1 and 2, then the system tries to find the CNA linked to only one device in Cancelled status. If found, the device is used for further processing the request.
- If the system does not find any device with status code as perstep 4, then system tries to find the CNA linked to the latest device. The device is used for further processing the request. This does not include CNA that is linked to a device with status as Cancelled.
Card Number Alias (CNA) processing logic- Device level uniqueness
- If the system locates a device with status code as Normal (0) or Upgrade (9 with upgrade status as 1), then that device is used for processing the request.
- If the system locates two devices; one with status code as Normal (0) and another with status code as Upgrade (9 with upgrade status as 1), and both have the same client ID, then the device with status code as Upgrade isselected and the request is processed on that device.
- If the CNA is linked to multiple devices with status code as Normal (0) or Upgrade (9 with upgrade status as 1), the request is rejected.
- If the system does not find any device with status code as per step 1 and 2, then the system tries to find the CNA linked to only one device in Cancelled status. If found, the device is used for further processing the request.
- If the system does not find any device with status code as per step 4, then the system checksifthe Device Plan Code and Program Code are present in API request. If found, the system tries to locate the CNA linked to the latest device. The device is used for further processing the request. This does not include CNA that islinked to a device with status as Cancelled. Once the Mini Statement API validation issuccessful, the statement details are sent as a response message.
Why would I need to use this resource? Third party enables the transaction history and services to cardholder using this API resource. In case of prepaid and credit card cardholders, you can fetch the ministatement based on the date range or can fetch the last transactions performed on the respective card. The maximum number of transactions records is displayed in the response as configured in the Institution Parameter Setup > System Codes against TYPE_ID = MINI_STMT_API_MAX_TXNS
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 |
|---|---|---|
| 400 | 997 | Invalid Request Type. |
| 400 | 997 | Form Factor Type field is mandatory. |
| 400 | 997 | Form Factor Type field is invalid. |
| 400 | 997 | Form Factor field is mandatory. |
| 400 | 997 | Form Factor field value must have max length 24. |
| 400 | 997 | Form Factor field value must have min length 10. |
| 400 | 997 | RRN field is mandatory. |
| 400 | 997 | RRN field should be numeric. |
| 400 | 997 | RRN field value must have size 12. |
| 400 | 997 | Trace Audit Number field is mandatory. |
| 400 | 997 | Trace Audit Number field should be numeric. |
| 400 | 997 | Trace Audit Number field value must have size 6. |
| 400 | 997 | Transaction Flag field is mandatory. |
| 400 | 997 | Transaction Flag field is invalid. |
| 400 | 997 | From Date field is mandatory. |
| 400 | 997 | From Date field must be in MMddyyyy format. |
| 400 | 997 | TO Date field is mandatory. |
| 400 | 997 | TO Date field must be in MMddyyyy format. |
| 400 | 997 | Request Txn Count is not allowed for 'Transaction Flag' : 0. |
| 400 | 997 | From Date is not allowed for 'Transaction Flag' : 1. |
| 400 | 997 | To Date is not allowed for 'Transaction Flag' : 1. |
| 400 | 997 | Request Txn Count field is mandatory. |
| 400 | 997 | Request Txn Count field should be numeric. |
| 400 | 997 | Request Txn Count field value must have max length 2. |
| 400 | 997 | Request Txn Count exceeds for 'Transaction Flag' : 1 'range 1 - 60'. |
| 400 | 997 | Note field value must have max length 100. |
| 400 | 997 | Form Factor Expiry Date field is mandatory. |
| 400 | 997 | Form Factor Expiry Date field must be in yyMM format. |
| 400 | 997 | No of months allowed exceeds for 'Transaction Flag' : 0 'range 1 - 6'. |
| 400 | 997 | Internal Error. |
| 400 | 997 | Product type is currently not supported. |
| 404 | 998 | Device Number does not exist. |
| 500 | 999 | Internal error. |
| 201 | 000 | No Transaction Available. |
| 400 | 997 | Only alphanumeric characters and underscore are allowed. |
| 400 | 997 | Product Type field is invalid. |
| 400 | 997 | Program Code field value must have max length 6. |
| 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 | Device Plan Code field value must have max length 10. |
| 400 | CNA005 | Multiple device numbers are active for given details. |
| 400 | CNA003 | Record does not exists for the given details. |
| 400 | CNA001 | Bank Does Not Exists |
| 400 | CNA002 | Card Number Alias Functionality is not applicable for this Institution |
| 400 | CNA006 | Error while fetching device details. |
| 400 | 997 | Card Number Alias field value must have max length 24. |
| 400 | 997 | Device Plan Code and Program Code are mandatory in request. |
| 400 | API_TXN_NOT_PERMITTED | Transaction not permitted to card holder. |
| 400 | CPI_MULTIPLE_DEVICE_FOUND | Multiple device numbers are active for given details. |
| 400 | CPI_NO_DEVICE_FOUND | Record does not exists for the given details. |