Release notes

Release date: July 1, 2026

Version 2.0.0

This is a major release. It introduces a new API version (/api/v2) with breaking changes to the request and response format. Existing integrations on /api/v1 continue to work unchanged, but moving to /api/v2 requires the updates marked ⚠️  Breaking change below. A migration checklist is provided at the end.

Features

New API version with a consistent response envelope

A new /api/v2 path set is available. Every successful v2 response is now wrapped in a predictable envelope — the business payload sits under data, alongside a requestId you can use for support and log correlation.

⚠️  Breaking change: on /api/v2, read the payload from body.data instead of the root of the response, and switch your URL prefix from /api/v1/... to /api/v2/....

Standardised error responses

All v2 errors now share one shape: a human-readable message and the requestId.

⚠️  Breaking change: the v1 code field is gone in v2. Read errors from body.message and remove any dependency on body.code.

Asynchronous processing acknowledged with 202 Accepted

Requests that can't be answered immediately are acknowledged with 202 Accepted carrying only a requestId; the terminal's response is delivered later to your configured WebhookUrl, wrapped in the same { data, requestId } envelope as synchronous responses.

⚠️  Breaking change: handle 202 Accepted for async flows and consume the webhook payload from data.

Mandatory Sales System identification

Every v2 request must now identify the calling software. Header.SalesSystemInfo is required and must include an IntegratorId (max 140 characters) and at least one SaleSoftware entry, each with a Type and a Status.VersionNumber.

⚠️  Breaking change: add a complete SalesSystemInfo block to every request. Missing or incomplete blocks are rejected with 400.

Stricter request validation for exchange identification

Header.ExchangeIdentification is now validated as a UUID on v2.

⚠️  Breaking change: generate a valid UUID for ExchangeIdentification on every request. Non-UUID values are rejected with 400.

Card Acquisition amounts restructured

currency, tipAmount, and totalAmount in Card Acquisition requests have moved into a new TransactionDetails object, aligning Card Acquisition with the standard PaymentRequest structure.

⚠️  Breaking change: move these three fields into TransactionDetails when building Card Acquisition requests.

Sale terminal data moved to Sale Context

SaleTerminalData now lives under Context.SaleContext to match the Nexo Retailer specification. The previous location is still read as a fallback and logged as deprecated. Support will be removed without further notice from this one when using v2.

⚠️  Breaking change (with fallback): move SaleTerminalData into Context.SaleContext. The old location keeps working for now but is deprecated and will be removed.

DCC refund support

Refunds can now carry dynamic currency conversion data via a new DCCRefund structure in PaymentTransaction, including rateReferenceIdentifier and originalTransactionDate.

Card expiry date in financial responses

Successful financial transactions now return the card expiryDate (YYMM), mapped to Environment.Card.PlainCardData.ExpiryDate in the Nexo response.

Bug fixes

Graceful handling when the payment app is missing

The app now handles the case where the WPI payment app is not installed, preventing protocol-level details from surfacing in the UI.

Correct authorisation mapping for transactions requiring signature

Signature-flow responses now map from the WPI result correctly (success → Approved, failure → Declined) and no longer return Suspended for successful signature transactions.

Abort responses

The app now sends an abort response to the caller whenever possible.

Loyalty card NFC handling

NFC handling for loyalty card reading has been improved so the flow proceeds smoothly.

Migration checklist (v1 → v2)

1. Switch the URL prefix from /api/v1/... to /api/v2/....

2. Generate a UUID for Header.ExchangeIdentification on every request.

3. Add a Header.SalesSystemInfo block (IntegratorId + at least one SaleSoftware with Type and Status.VersionNumber). Request the new values from your contact within Worldline

4. Read successful payloads from body.data.

5. Read errors from body.message; remove any body.code lookup.

6. Handle 202 Accepted for async requests and consume the webhook payload from data.

7. Move Card Acquisition currency / tipAmount / totalAmount into TransactionDetails.

8. Move SaleTerminalData into Context.SaleContext.

9. Send ProtocolVersion: "5.1-WL2.0.0" in the request header.

Release date: March 31, 2026

Version 1.5.0

Features

• Card Acquisition support

  Integrators can now trigger a Card Acquisition request through the API, allowing the terminal to read card data without initiating a payment. This supports use cases such as loyalty enrolment and card-based identification.

• Idempotency cache for duplicate request handling

  Duplicate requests with the same exchange identification are now detected and handled automatically. In-flight duplicates wait for the original response; already-completed duplicates return the cached response immediately. Cached entries are retained for 7 days.

Bug fixes

• Fix app not restarting after an upgrade

  The app now listens for the MY_PACKAGE_REPLACED broadcast to automatically restart after an update, ensuring the service resumes without manual intervention.

• Fix payment brand name in Card Acquisition responses

  The payment brand in Card Acquisition responses now correctly uses the application label from the payment app instead of a hardcoded value.

Updates

• Migrate to Koin for dependency injection

  The app dependency injection has been migrated from manual wiring to Koin with annotation-based modules, improving maintainability and reducing boilerplate across all layers.

Release date: March 11, 2026

Features

• Print mixed content in a single receipt request

You can now combine text, QR codes, and barcodes into one print request. This eliminates the risk of incomplete receipts caused by multiple separate requests failing midway.

• Structured JSON receipt format

Receipts can now be delivered in a rich, structured format alongside the standard plain-text format. Both can be requested at the same time, giving integrators full flexibility in how they display and process receipt data.

• Open the payment menu via API

The payment solution menu on the terminal can now be triggered directly through an API call, making it easier to integrate terminal navigation into point-of-sale workflows.

• Control whether the terminal prints the receipt

Integrators who manage their own receipt printing can now instruct the terminal to skip printing on its side, preventing duplicate receipts. The receipt data is still returned in the response regardless.

• Transaction reference echoed back in responses

Every transaction response now includes the same unique reference ID as in the original request, making it straightforward to match requests to responses and supporting idempotency.

• Terminal settings survive app downgrades

Terminal configuration is now backed up to the cloud. If the app is downgraded and reinstalled, which previously wiped all local settings, the terminal can restore its configuration automatically on first launch, with no manual setup needed.

Release date: March 4, 2026

Features

• Exponential backoff retry with 5 attempts starting in 2 seconds to resend the dropped messages

• Persist the unprocessed messages with automatic resend on reconnect

• Implement a stateless abort broadcast to cancel in-flight requests

• Add print receipt mapping with SmartPOS API

• Add RetailerPaymentResult with status messages request

• Return tip amounts in NEXO PaymentResponse

• Improve WPI Intent Action for Admin Requests

• Add support for refund message status and repeated reversal response

Bug fixes

• Resolve missing webhook responses

• Enhance error remark handling in the WPI response

• Map NEXO AllowedEntryMode to WPI useManualPanKeyEntry

• Map NEXO line width to WPI receiptWidth

• Map WPI DCC fields to NEXO CurrencyConversionResult

• Echo full Cashier-ID in NEXO responses

Release date: January 9, 2026

• Feature

  • TAPI app now runs in the background automatically and remains active after device reboot.

• Bugfix

  • Fix the Abort transaction.

Release date: January 9, 2026

Features

• Adds support for Administrative Acquirer Initialization (ACQI) and Terminal Configuration (TCFG) requests.

• Adds support for the "DocumentQualifier" and "MessageDestination" fields in Nexo Responses in JSON tags format (e.g., "CustomerReceipt" instead of "CRCP").

Bug fixes

• CreationDateTime header now reflects the time the response was created, not the time the initial request was sent.

• Fixes OriginalPaymentTransaction.TransactionType being "Error" in the Reversal Responses.

• Makes the font size in the EV screens resizable to adapt to the default system font size.

Updates

• Enhances navigation experience in the app.

• Improves the error response reason to be more informative.

Release date: September 16, 2025

Features

• Enables the clients to open customizable screens meant for EV Charger use cases. More information here [TBA].

• Adds support for cancelling a Reservation (Pre Authorization).

• Adds the missing ApplicationIdentifier field to the Nexo Card model, enhancing payment transaction tracking capabilities.

Bug fixes

• On S1U2 terminals, opening the menu with the physical button or emulator Menu button no longer loops back to idle; the menu now stays open until you close it.

• Credentials no longer disappear after reboot by preserving UMID and UTID across restarts.

• Adds flexible currency support to the amount screen; optional currency field (up to 4 characters, € / EUR), and hides currency in the response input to ensure correct amounts across EU currencies.

• Fixes WebhookUrl and NumberOfRetries missing from the rejection response headers.

• Adds support for Nexo JSON tags for the EV Charging feature.

• Fixes UI related requests not following the Nexo Specification regarding the placement of the fields.

Updates

• Switches from Nexo Retailer abbreviations to the full code names for better readability in our APIs (e.g., SFSQ to SaleFinancialServiceRequest). For more information, check out our migration plan guide .

Features

• Adds support for async payment.

• Adds support for Follow On Debit and Follow On Credit.

Updates

• Adds support for CardDataEntryMode = PHYS for purchase requests; maps to WPI manual entry mode and enables manual card data entry in purchase flows.

• Removes SupplementaryData from ReconciliationResponse and replaces it with PaymentReceipt.

• Removes receipt line width support; the LineWidth field is no longer sent in requests for Castle and Integrated terminals.

• Adds new App & Notification icon.

Bug fixes

• Aborted transactions now return ABRT/Aborted instead of NALW/NotAllowed, improving Cancel/Abort flow.

• Fixes intermittent connection issues to improve reliability.

• Fixes Terminal App navigation to Idle after a connection is established from the Configuration screen (no longer stuck in setup).

• Fixes the visibility of the current configuration when reconfiguring the Terminal App.