Skip to main content
Version: 3.2

Remote Actions

Remote-actions have several types and statuses. Statuses and transitions are described in the Flow section.

Types:

  • [Purchase]: A purchase remote-action will trigger a purchase operation on the terminal. Purchase means payment from customer to merchant.40

    The only required parameter is the amount. You can force a payment method (card / cashless) or let the user choose. You can choose to print or not a receipt on the terminal. For cashless payment: you can allow partial payment (for gift cards with insufficient balance).

  • [Refund]: A refund remote-action will trigger a refund operation on the terminal. Refund means payment from merchant to customer.

    The only required parameter is the amount. You can force a payment method (card / cashless) or let the user choose. You can choose to print or not a receipt on the terminal.

  • [Void]: A void remote action will trigger a void operation on the terminal. Void means cancellation of a previous purchase or refund.

    The only required parameter is the remoteActionId of the purchase or refund you want to void. You can choose to print or not a receipt on the terminal.

  • [Closing]: A Closing remote action will trigger a closing operation on the terminal. The closing is usually triggerred at the end of the day or shift to close the cash register and balance the transactions. All transaction will be (re)synchronized with the backoffice. You can choose to print or not a receipt on the terminal.

    [Get Cashless Balance]: A Get Cashless Balance remote action will ask the terminal to read the balance of a cashless card.

DRAFT : To be continued. Pre-auth and cashless related calls will be added in the next version of the documentation, by 18/02/2026.