Connect a payment gateway (QRIS & e-wallets)
Connect your business's own Xendit or Midtrans account to accept dynamic QRIS and e-wallets, including guests paying from their phone.
On this page
Dynamic QRIS, a QR code with the amount pre-filled and the payment confirmed automatically, is generated by a payment gateway. P&P Cashier connects to a gateway account owned by your business, so funds go straight to your bank account, not through us.
Supported gateways: Xendit and Midtrans.
Why do you need a gateway?#
Without a gateway, you can still sell with cash, EDC, and transfer. A gateway is needed for:
- Dynamic QRIS on the cashier screen and waiter phones.
- E-wallets (OVO, DANA, ShopeePay, and more).
- Guests paying and splitting the bill on their own phone via QR.
- The pay QR on the pre-bill.
- Automatic refunds through the gateway (where the gateway supports it).
Before you start#
- Sign up for and activate an account with Xendit or Midtrans (verification is handled by the gateway, not by us).
- From the gateway dashboard, get your secret key / server key and webhook verification token.
- Make sure you’re logged in to Back Office as an Owner or Manager.
Connecting#
- Open Payment gateways. Go to Back OfficeSettingsPayment gateways, then tap Connect gateway.
- Choose the “Business-owned account” mode and the Provider (Xendit or Midtrans).
- Choose the Environment. Sandbox for testing without real money, Production for live transactions.
- Choose the scope. All outlets, or specific outlets if they have a separate gateway account.
- Enter a Display name, such as your legal business name, so it’s easy to tell accounts apart.
- Paste the secret key and webhook token from the gateway dashboard. Hints on where to find each key in the dashboard appear under each field.
- Save & test. The connection is tested automatically. A Connected status means you’re ready.
- Copy the Webhook URL shown, then paste it into the webhook/notification settings in the gateway dashboard. Without this, payment statuses won’t update automatically.
Linking to a payment method#
- Open Payment methods. Back OfficeSettingsPayment methods.
- Edit the QRIS method (or add an E-wallet method), then choose the Payment gateway account you just connected.
- Turn the method on per outlet in Back OfficeSettingsPayment flow.
Managing gateway accounts#
On the Payment gateways page, each account shows its status, when it was last tested, its capabilities (QRIS, E-wallet, API refunds), and the methods that use it.
| Action | When |
|---|---|
| Test connection | After changing settings in the gateway dashboard |
| Replace key | The key leaked or was rotated; the connection is retested right away |
| Edit name / scope | Moving the account to another outlet |
| Disconnect gateway | You stop using that account (deactivate or move the methods that use it first) |
Fees#
Per-transaction fees for QRIS and e-wallets (MDR) are charged by the gateway under your agreement with them, for example around 0.7% for QRIS. Check the latest rates in the gateway dashboard.
Was this guide helpful?
Thanks! Glad it helped.
Thanks for the feedback. Want us to help you directly?
Ask on WhatsApp