Prerequisites

Before you integrate, confirm you have:

• Sunmi terminal for UAT testing, or any Android phone/tablet for mock-only development
• UAT account and login PIN from Peach Payments (required for UAT terminal testing only)

Contact support to request a UAT account and PIN.

Two starting paths

Path A - Mock Payments App (no payment terminal needed)

1. Download the Mock Payments App APK from Test your integration.
2. Install the Mock APK and your POS app on the same device.
3. Add com.peach:intent_api to your project - see App-to-app integration.
4. Run sale, refund, void, and lookup flows against the mock host.

No UAT account or Maven access token is required for mock-only development.

Path B - UAT terminal

1. Request a UAT account and PIN from support.
2. Download and install the UAT Payment App APK from Test your integration.
3. Add com.peach:intent_api to your project - see App-to-app integration.
4. Install your POS app on the same Sunmi device.
5. Log in to the UAT Payment App with your PIN.
6. Run the test matrix on Test your integration.

Library

Add the Intent API library from the public GitLab Maven repository - no access token required:

repositories {
    maven {
        url 'https://gitlab.com/api/v4/projects/61399867/packages/maven'
    }
}

dependencies {
    implementation 'com.peach:intent_api:2.0.8'
}

Pin the version Peach Payments confirms for your integration. See App-to-app integration for full installation steps.

Roles - integrator vs Peach Payments

Next steps

1. App-to-app integration: install the library and quick starts.
2. Terminal integration flows: sale, refund, void, and recovery.
3. Test your integration: mock app and UAT test matrix.