post
https://uatmea-iss-apigw.creditpluspinelabs.com/deviceapi/apis/payments/prepaid-cards//jit-fundings
JIT (Just-In-time) funding is a method of automatically funding a prepaid wallet in real time during a transaction. With JIT funding, prepaid accounts do not need to carry a balance. Instead, the Pine Labs platform automatically moves funds from your funding source or credit line into the appropriate wallet at the time of transaction.
The JIT Funding API is used to,
- assign preapproved credit limit for the loan account of the cardholder.
- increase or decrease the credit limit of the loan account of the cardholder.
- zeroize the credit limit of the loan account if the cardholder wants to close the loan account.
This API also supports transaction reversals. While raising the reversal request, you must ensure that the rrn parameter value passed is similar to the original transaction. Only full amount reversals are allowed. It is applicable for prepaid products issued on Pine Labs platform
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.
- Description: This is the description of the error code returned by Credit+ Issuing application.
- Details: This is the detailed description of the error code returned by Credit+ Issuing application
| HTTP Code | Reason Code | Description | Details |
|---|---|---|---|
| 200 | OK | The server has successfully processed your request. | |
| 400 | INVALID_FIELD_VALUE | 'type' field value '' is invalid | 'type' field value must be one of ['TOPUP','DEBIT','TOPUP_REVERSAL','DEBIT_REVERSAL'] |
| 400 | INVALID_FIELD_VALUE | 'traceAuditNumber' field value '' must match '[0-9]*' | |
| 400 | INVALID_FIELD_VALUE | 'remarks' field value '' must match '[a-zA-Z0-9 ,&.'-]*' | |
| 400 | INVALID_FIELD_VALUE | 'currency' field value '' is invalid | |
| 400 | INVALID_FIELD_VALUE | 'amount' field value '' must be greater than or equal to 1 and less than or equal to 9999999999.99999 | |
| 400 | INVALID_FIELD_VALUE | 'timestamp' field value '' must match 'YYYY-MM-DDThh:mm:ss[.sss]Z' or 'YYYY-MM-DDThh:mm:ss[.sss]±hh:mm' | |
| 400 | INVALID_FIELD_VALUE | 'originalTraceAuditNumber' field value '' must match '[0-9]*' | |
| 400 | INVALID_FIELD_VALUE | 'originalTransactionTimestamp' field value '' must match 'YYYY-MM-DDThh:mm:ss[.sss]Z' or 'YYYY-MM-DDThh:mm:ss[.sss]±hh:mm' | |
| 400 | INVALID_FIELD_VALUE | 'rrn' field value '' must match '[0-9]*' | |
| 400 | INVALID_FIELD_VALUE | 'X-MC-Source' field value '' is invalid | |
| 400 | INVALID_FIELD_VALUE | 'X-MC-Channel' field value '' is invalid | |
| 400 | INVALID_FIELD_VALUE | 'originalTraceAuditNumber' field value must be empty/blank or field must be absent in the request | 'originalTraceAuditNumber' field value must be blank or absent for TOPUP and DEBIT transactions. |
| 400 | INVALID_FIELD_VALUE | 'originalTransactionTimestamp' field value must be empty/blank or field must be absent in the request | 'originalTransactionTimestamp' field value must be blank or absent for TOPUP and DEBIT transactions. |
| 400 | INVALID_FIELD_VALUE | 'Card Number Alias' field value '' is invalid. | Invalid Card Number Alias |
| 400 | INVALID_FIELD_VALUE | 'Card Number Alias' field value '' is invalid. | Card Number Alias should belong to Primary Card |
| 400 | INVALID_FIELD_VALUE | 'Card Number Alias' field value '' is invalid. | Credit Line is not created for this Card Number Alias |
| 400 | INVALID_FIELD_VALUE | 'currency' field value '' is invalid. | Transaction currency should be same as program currency. |
| 400 | INVALID_FIELD_VALUE | 'amount' field value '' is invalid. | Credit Line available balance is less than Requested Debit amount. |
| 400 | INVALID_FIELD_VALUE | 'amount' field value '' is invalid. | Full amount reversal allowed. |
| 400 | INVALID_FIELD_VALUE | 'rrn' field value '' is invalid. | Reference number should be same as original reference number. |
| 400 | INVALID_FIELD_LENGTH | 'rrn' field value length must be 12 characters. | |
| 400 | INVALID_FIELD_LENGTH | 'traceAuditNumber' field value length must be 6 characters. | |
| 400 | INVALID_FIELD_LENGTH | 'currency' field value length must be 3 characters. | |
| 400 | INVALID_FIELD_LENGTH | 'originalTraceAuditNumber' field value length must be 6 characters. | |
| 400 | INVALID_FIELD_LENGTH | 'remarks' field value length must be less than equal to 100 characters. | |
| 400 | MISSING_REQUIRED_FIELD | Missing Required Field 'type'. | |
| 400 | MISSING_REQUIRED_FIELD | Missing Required Field 'rrn' | |
| 400 | MISSING_REQUIRED_FIELD | Missing Required Field 'traceAuditNumber'. | |
| 400 | MISSING_REQUIRED_FIELD | Missing Required Field 'currency'. | |
| 400 | MISSING_REQUIRED_FIELD | Missing Required Field 'amount'. | |
| 400 | MISSING_REQUIRED_FIELD | Missing Required Field 'timestamp'. | |
| 400 | MISSING_REQUIRED_FIELD | Missing Required Field 'originalTraceAuditNumber'. | 'originalTraceAuditNumber' field value is mandatory for DEBIT_REVERSAL and TOPUP_REVERSAL transactions. |
| 400 | MISSING_REQUIRED_FIELD | Missing Required Field 'originalTransactionTimestamp'. | 'originalTransactionTimestamp' field value is mandatory for DEBIT_REVERSAL and TOPUP_REVERSAL transactions. |
| 400 | RECORD_NOT_FOUND | Record not found for given search criteria(s). | Unable to Track the Original Transaction Details. |
| 403 | AUTHORIZATION_ERROR | User is not authorized to access requested resource | |
| 409 | CONFLICT | The API request cannot be completed because the requested operation would conflict with an existing item/record. | Reversal already processed for requested details. |
| 409 | CONFLICT | The API request cannot be completed because the requested operation would conflict with an existing item/record. | Duplicate Request |
| 500 | SYSTEM_ERROR | An unexpected error has occurred with the service you have requested |