No results

GET/mccExchangeRates

PROD
https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/mccExchangeRates
TEST
https://xpaysandbox.nexigroup.com/api/phoenix-0.0/psp/api/v1/mccExchangeRates

PARAM HEADER
NAME DESCRIPTION FORMAT
Correlation-Id Mandatory field in UUID v4 format.
The purpose of this field is to trace the request across different systems, making debugging and request tracking easier.
 String
Format: uuid
Example: 123e4567-e89b-12d3-a456-426614174000
X-Api-Key Authentication API Key. String
Format: uuid
Example: 625b4884-38f8-11ed-a261-0242ac120002
PARAM PATH
NAME DESCRIPTION FORMAT
No param path
PARAM QUERY
NAME DESCRIPTION FORMAT
pageNumber Number
Default: 1
pageSize Number
Default: 100
PARAM BODY

NAME DESCRIPTION FORMAT
No param body
Arrow RESPONSE 200
Success - No Header for this response
BODY
NAME DESCRIPTION FORMAT
exchangeRates Object containing exchange rate information. Array
code Currency name or numeric code (ISO 4217) String
Example: 380
numericcode ISO 4217 alpha-3 currency code String
Example: EUR
exchangeRate Exchange rate applied for conversion to terminal base currency Number
Example: 1.0654
exchangeRateDate Date of applicability of the exchange rate in yyyy-MM-ddTHH:mm:ss+0000 format String
Example: 2026-08-22T22:03:12+0000
exchangeRateExpiration Expiration date of the exchange rate in yyyy-MM-ddTHH:mm:ss+0000 format String
Example: 2026-08-24T22:03:12+0000
pagination Pagination information for the response.
 Object
page Current page number (1-based index).
 Integer
pageCount Total number of pages available based on the total items and page size.
 Integer
pageSize Number of items per page.
 Integer
total Total number of items matching the search criteria.
 Integer
Arrow RESPONSE 400
Invalid request data - No Header for this response
BODY
NAME DESCRIPTION FORMAT
errors Array containing the errors list. The possible values are shown in the table Error codes.
 Array
code Error code.
 String
Example: GW0001
description Error description.
 String
Example: Invalid merchant URL
Arrow RESPONSE 401
Unauthorized - No Header and Body for this response
Arrow RESPONSE 403
Forbidden - No Header for this response
BODY
NAME DESCRIPTION FORMAT
errors Array containing the errors list. The possible values are shown in the table Error codes.
 Array
code Error code.
 String
Example: GW0001
description Error description.
 String
Example: Invalid merchant URL
Arrow RESPONSE 500
Internal Server Error - No Header for this response
BODY
NAME DESCRIPTION FORMAT
errors Array containing the errors list. The possible values are shown in the table Error codes.
 Array
code Error code.
 String
Example: GW0001
description Error description.
 String
Example: Invalid merchant URL

NOTE: the exchange rates shown and returned by this API are applicable only to Nexi customers. For Intesa Sanpaolo customers, the exchange rates applied to each individual transaction are returned through other methods.