Setting up payment gateways

Before customers can pay online, you need to connect a payment gateway. For most regions that’s Stripe — your own Stripe account, so card revenue settles directly to your bank with SupaOrder taking zero commission. This page covers connecting the gateway, choosing which methods customers see, and verifying everything before launch.

Before you start

You’ll need:

An admin login to the dashboard
A Stripe account for your business (create one at stripe.com if you don’t have one — activation requires your business details and bank account)
Your Stripe account fully activated for live payments (Stripe verifies your business first; test payments work before that, live ones don’t)

Connect your Stripe account

In the dashboard, open Dashboard → Settings → Payment → Payment Provider (/configuration/payments/payment/payment-gateway-list).
Add Stripe as a gateway and enter your Stripe account credentials (API keys from your Stripe dashboard). Use test keys first if you want to dry-run with test cards, then switch to live keys for launch.
Save, then use Test Connection to verify SupaOrder can talk to your Stripe account. A successful test confirms the keys are valid and the account is reachable.
Enable the gateway so it appears as a payment option at checkout.

Apple Pay and Google Pay

Once Stripe is connected, Apple Pay and Google Pay can be offered in your customer app and web ordering — they process through the same Stripe account. Your SupaOrder onboarding team handles the device-wallet registration as part of app setup; you just confirm you want them enabled.

Choose which payment methods customers see

With the gateway connected, decide what appears at checkout. Each method customers can pick is an entry under Dashboard → Settings → Payment → Payment Config (/configuration/payments/payment/list):

Online methods — cards, Apple Pay, Google Pay, store wallet
Physical methods — cash, card on delivery, card terminal, bank transfer

Each entry carries a display Name and Description (what customers read at checkout), a Priority (its position in the list), visibility settings, and a conditions builder — so you can, for example, require prepayment for delivery while allowing cash for pickup. Entries can also carry an optional per-method Fee, Cashback, or Reward Points if you want to price or incentivize methods differently.

Methods can also be enabled or disabled per outlet under Dashboard → Outlets → (outlet) → Payment (/outlet/manage/:outletID/payment/list), so a kiosk location can be card-only while your main restaurant takes everything. See the Payments overview for how each method behaves.

When you disable a method, it disappears from checkout immediately. Customers who had it saved as their preference are simply prompted to pick another method on their next order — nothing breaks.

Go-live checklist

Run through this before announcing your launch:

Live keys in place — gateway configured with live (not test) Stripe keys.
Test Connection passes — green check in the gateway configuration.
Real-card test order — place a small order with a real card, confirm it appears as paid in the partner app, and confirm the charge shows in your Stripe dashboard.
Apple Pay / Google Pay test — if enabled, place one order with each on a real device.
Refund test — refund the test order from the order details and confirm the refund appears in Stripe. See Editing orders & refunds.
Physical methods reviewed — only the methods you actually accept are enabled per outlet.
Taxes and charges verified — totals on the test order match what you expect. See Taxes & charges.
Payout schedule confirmed — check your bank payout schedule in the Stripe dashboard so you know when money lands.

Managing the gateway day to day

Watch your Stripe dashboard for payouts, disputes, and chargebacks — disputes are raised by the customer’s bank and answered through Stripe.
Key rotation — if you rotate or regenerate Stripe API keys, update them in Payment Provider immediately and re-run Test Connection; old keys stop working the moment they’re rolled.
Reconcile with reports — the payment-wise report (Dashboard → Reports, /reports/payment-wise) breaks orders down per payment method, for checking recorded orders against your Stripe payouts. See Reports & analytics.
Disabling a gateway — switching a gateway off removes all its online methods from checkout at once. Useful in an emergency, but customers can then only order with whatever physical methods remain enabled.

Troubleshooting

Symptom	Likely cause	Fix
Every card payment fails	Test keys in live mode, or Stripe account not activated	Switch to live keys; complete Stripe activation
Test Connection fails	Mistyped or rotated keys	Re-copy keys from the Stripe dashboard and save again
Apple Pay button missing	Wallet not enabled, or unsupported device/browser	Confirm with your onboarding team that wallet registration is complete
Customer says they were charged but no order arrived	Payment authorized but order placement interrupted	Check Stripe for the charge — uncaptured authorizations release automatically; contact support if a captured charge has no order
Refund not arriving	Bank processing time	Card refunds take 3–10 business days; check the refund status in Stripe

Still stuck? SupaOrder support can inspect your gateway configuration with you — reach out any time.

Next: configure taxes & charges, then run a full test order from the launch checklist.