Terminal payments overview

Terminal payments

Push amount + currency from your CRM/POS to a signed-in MainMoney terminal. The cashier finishes the sale on the device (palm, phone, QR, or cash). Your backend learns the outcome from signed webhooks.

Payment linksTerminal payments
Where the payer paysHosted MainMoney URLIn-store terminal
Who chooses the methodPayer on the web pageCashier on the device
Your jobCreate link + redirectCreate payment + handle webhook

Five steps

  1. Authenticate with OAuth client credentials.
  2. Discover merchants (GET /merchants) and terminals (GET /terminals).
  3. Create a terminal payment (POST /terminal-payments) with merchantReference.
  4. The signed-in terminal prefills amount and currency; the cashier chooses the method.
  5. Receive terminal_payment.* webhooks (or poll GET /terminal-payments/:id).

Next