post
https://uatmea-iss-apigw.creditpluspinelabs.com/deviceapi/apis/institutions//exchange-rates
This API is used to add or update the bank ratesfor any currency pairfor the purpose of currency conversion at the time of transaction processing. The updated rate will be used for transactions as per configuration in Card Management> Institution Parameter Setup> Currency Exchange Rates Mapping screen.
NOTE: While adding or updating the bank rates for a currency pair, Credit+ Issuing compares the bank rates with the latest Pine Labs rates. If the variance is greater than configured percent (default 10 percent), then Credit+ Issuing rejects the record with an error message.
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 | OK | The request has been fulfilled and resulted in a new resource being created. |
| 400 | MISSING_REQUIRED_FIELD | Error example: Missing Required Field 'baseCurrency'. |
| 400 | INVALID_FIELD_FORMAT | Invalid Field Format Base Currency. |
| 400 | INVALID_FIELD_LENGTH | Program Code Size must be between 2 and 10. |
| 400 | INVALID_PROGRAM_CODE | Program code 'XYZ' must be part of multi-currency program. |
| 400 | INVALID_CURRENCY_CODE | Currency code 'XYZ' is not configured for your institution. |
| 400 | INVALID_EFFECTIVE_FROM | Effective From should be greater than institution date or less than institution date + 6 months. |
| 400 | INVALID_CURRENCY_CODE_+_EFFECTIVE_FROM_PAIRS_COMBO | Requested pairs can have same currency but effective date should be different. |
| 400 | ISE40011 | Tolerance Refund unit value is greater than tolerance refund unit configured at institution level. |
| 400 | ISE40011 | Tolerance load unit value is greater than tolerance load unit configured at institution level. |
| 400 | ISE40011 | Minimum value for 'Tolerance Load/Refund' is 0. |
| 400 | HIGH_BUY_RATE_VARIANCE | Buy rate variance with Pine Labs rate is more than x%. Pine Labs buy rate: 'XYZ' |
| 400 | HIGH_MID_RATE_VARIANCE | Mid rate variance with Pine Labs rate is more than x%. Pine Labs mid rate: 'XYZ' |
| 400 | HIGH_SELL_RATE_VARIANCE | Sell rate variance with Pine Labs rate is more than x%. Pine Labs sell rate: 'XYZ' |
| 400 | NO_RECORD_FOUND_FOR_RATE_COMPARISON | No record found for rate variance comparison |
| 403 | PERMISSION_DENIED | It seems you don't have permission to access this API. |