Point of sale
Introduction
Peach Payments enables in-store card payments through the Payment App on Sunmi terminals. If you ship your own POS app on the same device, you integrate using the Intent API (com.peach:intent_api). If your till runs on a separate device, use till-point QR.
This documentation focuses on South African integrators using Sunmi payment terminals. For Mauritius's MauCAS on the Peach Payments Soundbox device, see MauCAS Soundbox.
Regions and hardware
| Region | Hardware | Integration |
|---|---|---|
| South Africa | Sunmi payment terminals | App-to-app (Intent API) or till-point QR |
| Mauritius | Peach Payments Soundbox (NEXGO) | MauCAS Soundbox |
Payment methods
Card-present payments on Sunmi terminals. The Payment App handles card processing; your POS app initiates transactions via the Intent API or till-point QR.
Choose your integration
| Pattern | When |
|---|---|
| App-to-app | Your POS app runs on the same Android device as the Payment App |
| Web POS in WebView | Web UI inside your Kotlin shell on the terminal - uses the same Intent API bridge |
| Till-point QR | Your till runs on a separate device (tablet, PC, phone) |
See Integration patterns for details on which pattern to use.
What you need from Peach Payments
| Item | Required for | How to get it |
|---|---|---|
| UAT account and login PIN | UAT terminal testing | Contact support |
| Sunmi terminal (UAT or production) | Hardware testing | Peach Payments or your channel partner |
| Point of sale webhooks | Till-point QR; optional for app-to-app | Contact support with your HTTPS URL |
com.peach:intent_api Maven dependency | App-to-app | Public GitLab Maven - no access token required |
Quick links
App-to-app or till-point QR.
UAT account, mock app, and library setup.
Install the Intent API library and quick starts.
Sale, refund, void, recovery, and reconciliation.
Mock app, UAT terminal, and test matrix.
Upload and publish your APK on Sunmi.
Next step
Start with Integration patterns if you are unsure which path fits your architecture.