How to accept QRIS payments in an online store without confusing buyers
Understand how QRIS payments work in an online store, what sellers need to prepare, and why payment-provider verification affects checkout readiness.
To accept QRIS in an online store, a seller needs a QRIS-capable payment provider, completed verification, a configured checkout, and a tested payment-status and instruction flow before sharing the store.
Buyers know QRIS as a way to pay, but an online store has to manage more than a QR image. The system must connect a payment to the right order, show an understandable status, and explain what to do when confirmation has not arrived.
QRIS checkout has several parts
| Part | What to confirm |
|---|---|
| Payment provider | The provider supports the selected method and accepts seller onboarding |
| Verification | Requested business and identity data has been submitted and its status is understood |
| Checkout | The buyer can select QRIS and see the correct instructions |
| Order status | The seller can distinguish pending, successful, and failed orders |
| Buyer help | There is a path for cases where payment is complete but the status is delayed |
1. Choose a provider for the store's needs
An online-store platform usually connects checkout to a payment provider rather than processing funds itself. Ask which methods are available, which documents are required, how review works, and how payment status returns to the store. Do not choose only because a payment method appears in marketing copy.
2. Prepare the KYC information
- Use consistent identity and business information.
- Check the account holder or settlement recipient details if the provider requests them.
- Read the verification status, not only the message that registration was submitted.
- Keep the provider's support information in case data needs correction.
Payment-provider KYC or verification is not always immediate. During the review, a seller may be able to prepare the storefront but not enable checkout or accept payments. The status should be clear to anyone handling orders so the store does not promise an outcome that is not ready.
3. Write QRIS instructions that do not make buyers guess
- Say when the buyer should open the payment app.
- Explain that the order is complete after payment status is confirmed.
- Provide a support path if the balance is deducted but the order status has not changed.
- Do not make a buyer's screenshot the only source of truth when the provider supplies a status.
4. Separate payment status from order status
A successful payment is an event from the provider. The seller processes the order after the store receives the corresponding status and checks its details. The terms are related, but they are not always identical at every stage. Document what the seller should do for pending, successful, expired, and failed states.
5. Test realistic scenarios
- The buyer chooses QRIS but closes the payment app before paying.
- Payment completes after the checkout page is closed.
- The provider has not sent confirmation when the buyer returns to the store.
- Payment fails and the buyer needs another method.
- The seller receives a duplicate order or a delayed notification.
What belongs on the payment page?
List methods that are actually available, explain when orders are processed, and say who handles payment problems. Avoid saying a method is instantly active or guaranteed to arrive when the provider is still reviewing KYC. Biome is designed for local payments through a payment provider, but checkout readiness still follows that provider's process.
A note about Biome's implementation scope
Biome's product documentation includes QRIS as one intended local payment method. This article does not turn that design target into a guarantee that a live provider integration is active for every store. Sellers should check product and verification status before making QRIS a promise in sales material.
Frequently asked questions
Can QRIS be used immediately after creating a store?
Not necessarily. QRIS readiness follows the payment provider and its KYC or verification process.
Is a payment screenshot enough proof?
It should not be the only source of truth. The seller should use the payment or store status supplied by the provider flow.
What if the buyer's balance was deducted?
Check the provider and order status and provide a support path. Do not treat a closed page or screenshot alone as confirmation.
Does Biome hold buyer funds?
The product design places payment processing with a payment provider; actual details follow the available integration and service status.