Overview
Learn about the modules, roles, and payment flows of the native SmartPOS app
Kushki ONE Payment App
The Kushki ONE Payment App is the native application that runs directly on SmartPOS terminals (Sunmi P2 SE, Sunmi P3). It serves two purposes: it allows the cashier to process card payments autonomously, and the merchant administrator to review sales, tips, and reports without leaving the device.
App structure
The app is organized into three sections accessible from the top navigation bar:
| Section | Purpose |
|---|---|
| Home | Active payment screen. This is where the cashier starts every new transaction. |
| Transactions | Reporting hub. Contains the Sales List, Sales Summary, and Tips List. |
| Settings | Terminal parameters: refunds, users, language, receipts, tips, and split payments. |
How the payment flow works
The cashier enters the amount and the customer presents their card — via NFC, chip, or magnetic stripe. The terminal sends the authorization request through Kushki to the card network processor (Visa, Mastercard, etc.). The result — Approved or Declined — is shown on screen and automatically recorded in the Sales List.
Each approved transaction generates:
- A unique 18-digit Ticket #, which serves as a reference both on the terminal and in the Kushki portal.
- A printable receipt with a copy for the customer and a copy for the merchant.
- A record available for email delivery, either individually or as a consolidated report.
Who does what
Two roles use the app differently. Understanding this distinction prevents cashiers from accessing settings that are not meant for them.
| Role | Typical access | Relevant articles |
|---|---|---|
| Cashier | Home, Sales List | Process a payment · Refunds |
| Administrator | Settings, Sales Summary, User Management | Terminal settings · Review your transactions · Auth & Capture |
Process a payment
Start with the main flow: enter the amount, present the card, and handle the result.
Terminal settings
Set up users, tips, receipts, and refunds before you start operating.
Colombia
Ecuador
Mexico
Peru