DOCUMENTATION
E-Commerce Integration
Add instant QR payments to your online store with our API and SDK. Go from sandbox to live in minutes.
GET STARTED IN 5 STEPS
From API keys to live payments
1
Get API Keys
Retrieve your API credentials from the Merchant Portal.
2
Integrate SDK
Add the miaPOS JavaScript SDK or use the REST API directly.
3
Test in Sandbox
Validate your integration in the sandbox environment.
4
Go Live
Switch to production credentials and enable real payments.
5
Accept Payments!
Customers pay via QR code directly on your checkout page.
STEP 1
Get Your API Keys
Log in to the Merchant Portal and navigate to the Online Payments section. Here you will find your API key and secret for both sandbox and production environments. Keep your secret key secure and never expose it in client-side code. Each store in your account can have its own set of credentials.
STEP 2
Integrate the SDK
Add the miaPOS JavaScript SDK to your checkout page, or integrate directly via the REST API from your backend. The SDK handles QR code rendering, payment status polling, and callback notifications. For custom integrations, the API provides endpoints for creating payment sessions, checking status, and processing refunds.
STEP 3
Test in Sandbox
Use the sandbox environment to test your integration without processing real money. The sandbox simulates the full payment flow including QR generation, customer scan, and payment confirmation callbacks. Verify that your webhook handler correctly processes success and failure notifications before going live.
STEP 4
Go Live
Once testing is complete, switch your API credentials from sandbox to production in the Merchant Portal. Update your configuration to use the production endpoint. No code changes are needed if you followed the SDK documentation -- just swap the keys and base URL.
STEP 5
Accept Payments!
Your online store is now live with miaPOS payments. Customers see a QR code at checkout, scan it with their banking app, and confirm the payment. You receive a real-time webhook notification, and the transaction appears in your Merchant Portal with full details. Monitor your online operations from the dedicated dashboard section.
Frequently Asked Questions
Which platforms and languages are supported?
The JavaScript SDK works with any web frontend. The REST API can be called from any backend language (PHP, Python, Node.js, Java, etc.). We provide code examples and Postman collections in our developer documentation.
How do refunds work for online payments?
You can initiate refunds from the Merchant Portal or via the API. Full and partial refunds are supported. Refunds are processed back to the customer's original payment method within one business day.
Is there a transaction limit for online payments?
Transaction limits depend on your merchant agreement with the acquiring bank. Default limits are typically set during onboarding. Contact your bank to review or adjust your limits.
Can I use E-Commerce and POS payments with the same account?
Yes. Your miaPOS merchant account supports all payment channels: POS, SoftPOS, E-Commerce, miaLINKS, and Request to Pay. All transactions are consolidated in a single Merchant Portal dashboard.
Ready to integrate online payments?
Get your API keys, explore the documentation, and start testing today.
Open Merchant Portal