Multi-Vend with Pre-Auth

Multi Vend with Pre-Authorization is a flow where the customer first presents their payment card for authorization before selecting any products. Once the payment is approved and the session begins, the customer can select multiple products within that single session without needing to authorize each selection separately.

This approach improves convenience by allowing multiple items to be purchased in one go after a single payment authorization, streamlining the transaction process.

Multi Vend Flow

See the diagram below:

Where:

  1. Card Holder presents the card to the Nayax Device.
  2. Nayax Device sends an authorization request to the Nayax Server.
  3. Nayax Server forwards the authorization request to the Billing Provider.
  4. The billing Provider sends an authorization response (approved) to the Nayax Server.
  5. Nayax Server sends the authorization response (approved) back to the Nayax Device.
  6. Vending Machine SDK begins the session and triggers the session begin event handler (vmc_vend_event_handler_cb(vm_vend_event_on_session_begin)).
  7. Message to Card Holder: "Please Select a Product."
  8. Card Holder selects multiple products.
  9. Vending Machine SDK sends a multi vend request vmc_vend_vend_request(vend_session_t *session) to the Nayax Device.
  10. Vending Machine SDK transfers transaction data internally and triggers the transaction info event handler vmc_vend_event_handler_cb(vm_vend_event_on_transaction_info).
  11. SDK triggers the vend approved event handler vmc_vend_event_handler_cb(vm_vend_event_on_vend_approved).
  12. Vending machine dispenses the products.
  13. SDK reports multi-vend success vmc_vend_vend_status(&session, __true) and completes the vend session vmc_vend_vend_session_complete_lowlevel().
  14. Message to Card Holder: "Please Take Products."
  15. Nayax Device sends a settlement request to the Nayax Server.
  16. Nayax Server forwards the settlement request to the Billing Provider.
  17. The billing Provider sends a settlement response (OK) to the Nayax Server.
  18. Nayax Server returns the settlement response (OK) to the Nayax Device.
  19. The vending session ends.
  20. Message to Card Holder: "Thank you & Goodbye."