The Cloud API is a REST/JSON API over HTTPS. Unlike the Local API and App-to-App, it does not use the nexo Sale-to-POI message model — there is no MessageHeader, and there is no Login/Logout session. Each request is a plain REST call authenticated by your client certificate.
Base URLs
| Environment | Base URL |
|---|---|
| Production | https://eci.market-pay.com |
| Pre-production | https://eci-stg.market-pay.com |
Firewall access to Market Pay services is covered in Configure your network.
Addressing a terminal
The terminal is identified in the URL path as MANUFACTURER:SERIAL, for example PAX:1760019815. The manufacturer prefix is case-sensitive and must be uppercase.
Amounts and currency
-
amountis in minor units:1000means €10.00. It already includes any tip and cashback. -
currencyis an ISO 4217 numeric code:978= EUR,208= DKK,578= NOK. It must match the terminal's configured currency.
The identifiers you must get right
| Identifier | Rule |
|---|---|
ecrTransactionId |
Your transaction reference. 35 characters maximum — longer values are rejected. |
terminalTransactionId |
Returned by the terminal in the result. Persist it — cancellations and pre-authorization completions reference it. |
terminal-id |
MANUFACTURER:SERIAL, uppercase prefix. A lowercase prefix returns 404. |
Warning
ecrTransactionId over 35 characters (for example a raw 36-character UUID) is rejected. Use a shorter reference or truncate deterministically.
Note
See the Cloud API reference on the API Hub for the full type definitions (TransactionParams, TransactionResult, Notification, …).