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 the POS Integrations API.

Payment methods

Card-present payments on Sunmi terminals. The Payment App handles card processing; you initiate transactions via the Intent API or the POS Integrations API.

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
POS Integrations API	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 webhook set up	POS Integrations API; optional for app-to-app	Contact support with your HTTPS URL
POS Integrations API key	POS Integrations API	Contact support
`com.peach:intent_api` Maven dependency	App-to-app	Public GitLab Maven - no access token required