前置准备

在开始 Android 接入之前，请确保已完成 Native SDK 概览 中的准备流程和服务端集成。

环境要求

项目	要求
Android Gradle Plugin（AGP）	8.13.2
Java	17
Android SDK	compileSdk 36，targetSdk 36，minSdk 24
OkHttp	4.12.0
Gson	2.11.0
Retrofit	2.11.0

导入说明

手动集成

1. 下载收单 Android SDK 的 aar 文件。

   请联系技术支持获取。

2. Android Studio 工程中引入依赖。

   将 aar 文件复制到 module 的 libs 目录下，在 module 的 gradle 文件中添加依赖：

build.gradle

dependencies {
    implementation files('libs/payment-android-sdk-1.0.0.aar')
}

核心概念与交互时序

SDK 配置与关键对象

关键对象说明

类名	说明
PPPayment	SDK 主入口类
PaymentConfig	SDK 配置类
PaymentResult	支付结果回调（Sealed Class）
Environment	环境枚举（SANDBOX/ONLINE/ONLINE_US）

环境配置

环境枚举：

Environment.kt

enum class Environment {
    SANDBOX,     // 沙箱环境
    ONLINE,      // 生产环境-欧洲
    ONLINE_US    // 生产环境-美国
}

枚举值	说明	API 端点
SANDBOX	沙箱环境	https://sandbox-acquirer-payment.pingpongx.com
ONLINE	生产环境-欧洲	https://acquirer-payment.pingpongx.com
ONLINE_US	生产环境-美国	https://acquirer-payment-checkout-us.pingpongx.com

跨平台映射：

Android	iOS 等价	说明
SANDBOX	PPCDEnvironmentTypeSandBox	沙箱环境
ONLINE	PPCDEnvironmentTypeRelease	生产欧洲
ONLINE_US	PPCDEnvironmentTypeReleaseUS	生产美国

配置示例：

PaymentConfig 初始化

val config = PaymentConfig(
    environment = Environment.SANDBOX,    // 沙箱
    // environment = Environment.ONLINE,  // 生产欧洲
    // environment = Environment.ONLINE_US  // 生产美国
    logEnabled = true,
    cardBinLength = true
)

关键接入步骤

步骤 1：初始化 SDK

PaymentConfig.kt

val config = PaymentConfig(
    environment = Environment.SANDBOX, // 控制环境切换
    logEnabled = true, // 控制 SDK 日志开关
    cardBinLength = true // 设置卡 Bin 位数长度
)

步骤 2：唤起半屏支付

PaymentActivity.kt

// 1. 创建支付实例
val payment = PPPayment(activity, PaymentResultCallback { result ->
    when (result) {
        is PaymentResult.Completed -> {
            // 支付完成
        }
        is PaymentResult.Canceled -> {
            // 用户取消
        }
        is PaymentResult.Failed -> {
            // 支付失败
        }
    }
})

// 2. 唤起收银台
payment.presentPayment(
    token = "your_token",
    config = config
)

上一页iOS 接入指南

下一页合规接入指南