2 Phases Transaction
The two-phase transaction flow for the SHVA payment service divides a single transaction into two distinct steps:
- An initial information retrieval phase
- A subsequent authorization phase
This flow is often used by clients who implement a loyalty mechanism, as it allows for user interaction between the two phases, such as canceling or changing transaction values.
Transaction Flow
To understand the 2 Phase transaction flow, consider the following sequence of events:

Here's a breakdown of each step:
- The client application (labeled as DC) initiates the first phase of the transaction by sending a
doTransactionPhase1
request to the Nayax Device. - The Nayax Device prompts the CardHolder to present their card by either inserting, showing, or swiping it.
- The Nayax Device responds to the DC with a
doTransactionPhase1
response, which contains the card and transaction properties. - After any necessary user interaction (e.g., changes or cancellations), the DC sends a
doTransactionPhase2
request to the Nayax Device to complete the transaction. - The Nayax Device sends an authorization request to SHVA.
- SHVA processes the request and sends an authorization response back to the Nayax Device, which then relays the Authorization response to the DC.
- At the end of the day, the DC sends a
doPeriodic
request to the Nayax Device, which communicates with SHVA to complete the day's batch process. The Nayax Device then sends adoPeriodic
response back to the DC.
See Also
Updated about 2 hours ago