External Settlement

The External Settlement flow makes use of the following Spark methods:

The flow is initiated by the 3rd Party Server after the service or products have been provided to the consumer.

To understand the external settlement flow, see the diagram below:

Below is a breakdown of the diagram:

The process begins with transaction initiation on the Nayax Device. The device sends an StartAuthentication request to the Nayax Server.
The Nayax Server processes the request by performing authorization with a payment provider (an action external to the direct flow) and sends an Authentication Response back to the Nayax Device. Upon receiving this, the device is back to IDLE.
The 3rd Party Server initiates communication with the Nayax Server by sending a StartAuthentication message.
The Nayax Server acknowledges the notification by responding with a Start Authentication Response to the 3rd Party Server.
If Service/Product(s) are Provided: The 3rd Party Server sends an ExternalSettlement request to the Nayax Server. Simultaneously, the Nayax Server initiates financial finalization by settling with the payment provider.
The Nayax Server completes the settlement flow by sending an External Settlement Response back to the 3rd Party Server.

Alternatively:

If Service/Product(s) are Not Provided: The 3rd Party Server sends an ExternalCancel request to the Nayax Server. Simultaneously, the Nayax Server initiates the financial cancellation with the payment provider.
The Nayax Server completes the cancellation flow by sending an External Cancel Response back to the 3rd Party Server.

Failure Handling

Failure Type	Recommended Action	Retry Policy
Start Authentication Failure	The Third-Party Server/Spark Provider must retry the authentication request.	Not specified, typically immediate.
External Settlement Failure	The Third-Party Server/Spark Provider must retry the transaction settlement.	Up to 5 retries recommended, all within 24 hours of the initial attempt.
External Cancel Failure	No action is required by the 3rd-Party Server.	The Nayax Server will automatically retry the cancellation on the server side later.