Ping++聚合支付SDK 合规使用说明

引言

Ping++聚合支付SDK 由上海简米网络科技有限公司（以下简称“我们”）提供，通过集成支付宝、微信和银联支付 SDK，为开发者提供统一的 App 支付调用能力。

本说明用于帮助开发者落实告知同意、最小必要、权限管理、安全保护及个人信息权利响应等要求。Ping++ 聚合层不主动采集客户信息，但会处理应用传入的支付参数、转交所选渠道的必要凭证并接收支付结果。嵌套渠道 SDK 与支付 App 的信息处理应分别披露。

一、产品与责任边界

开发者作为其 App 运营者，负责依据实际版本和业务场景向最终用户准确披露信息处理规则、取得必要授权，并提供用户权利行使渠道。我们提供聚合支付调用能力、隐私政策与合规接入说明。渠道 SDK 和支付服务提供方分别适用其自身规则，各方实际责任以业务关系及协议为依据。

版本与升级

截至2026年10月13日，OHPM 包页面 展示版本为1.2.5，支持支付宝、微信及银联云闪付 App 支付，支持 live 模式的 charge、order 和 recharge 对象。

开发者应选择适配项目、满足适用监管要求的受支持版本，并在升级时核对渠道版本、权限、信息处理和回调变化。版本更新记录与合规检测结果应分别核对。

ohpm i @pingplusplus/pingppsdk

实际项目应锁定测试通过的版本并记录锁文件。页面 README 的编译 API 说明与侧栏最低兼容 API 信息存在差异，最低系统/API 要求应根据发行包元数据和实测结果核对。

本 SDK 已集成第三方支付库，项目接入时应避免重复导入。依赖为支付宝 @cashier_alipay/cashiersdk、微信 @tencent/wechat_open_sdk、银联 libuppayment 和同品牌基础库 @pingplusplus/pingppbase；确切版本及传递依赖待锁文件/发行包核实。

二、SDK 功能、个人信息与权限

1. 基本功能与个人信息

上述支付字段以所接入版本与实际渠道对象为准。用户拒绝相关处理时，可能无法完成对应支付，但不应影响其他无关功能。第三方 SDK 处理信息另见第四章。

2. 扩展功能、可选信息及采集频次

第三方 SDK 清单应与实际发行包及调用情况一致。关闭支付入口后，如发行包仍包含对应渠道库，应说明其集成及启用状态；发行包已移除对应库且不再调用该服务时，可同步调整清单。

3. 系统权限

根据本次 HAR 包接入 Demo 的验收测试结果，本 SDK 不申请或使用系统权限，开发者无需为接入本 SDK 额外声明权限。

开发者不应声明与 SDK 功能无关的系统权限，SDK 不使用其未声明但开发者应用已申请的其他权限。后续版本如新增权限，应在实际使用前更新权限清单、用途与调用时机，并完成必要的告知和授权。

#### 支付 App 跳转与回调配置

querySchemes、回跳 scheme 和 Want 回调用于查询支付目标是否可打开、拉起支付 App 及接收支付结果，属于链接或路由配置，不属于系统权限申请。仅配置实际使用渠道需要的项，且仅在用户主动使用对应支付功能时执行必要操作。

按当前包文档，支付宝需核对 querySchemes 中的 https 配置；云闪付示例列出 uppaysdk、uppaywallet、uppayvendor，其中 uppayvendor 对应华为 Pay。开发者应根据实际启用的支付能力及渠道接入要求按需配置上述路由项。https 配置用于相应链接查询，不用于查询完整已安装应用列表。

三、初始化与业务调用时机

1. 调用时序

1. 应用首次使用时，展示隐私政策及 SDK 清单，提供可查看的完整文本和清晰的同意、拒绝选项，不得默认勾选。
2. 在用户未同意时，不执行会激活 SDK 或渠道信息处理的注册、实例创建、初始化、预调用或预热操作；拒绝后，不调用对应支付功能。
3. 用户主动进入支付流程、选择渠道并确认支付后，完成所需告知与授权，再调用 Pingpp.createPayment(...)。
4. 渠道创建实例、注册及回调处理应按实际版本指南接入。回调仅处理用户已发起的支付，不在收到任意 Want 时激活新支付。
5. 支付取消、完成或授权撤回后，停止不必要的后续调用，清理应用持有的临时数据和回调引用。

当前 Ping++ 接入文档未列出独立的聚合层初始化接口、同意开关或数据删除接口。用户主动选择支付渠道并确认支付、应用完成必要告知与授权后，开发者调用 Pingpp.createPayment(...)，聚合层开始处理应用传入的当次支付参数；渠道返回支付结果或触发支付回调时，聚合层处理相应结果并返回应用。开发者应将会激活渠道信息处理的实例创建、注册及其他操作安排在完成必要告知与授权且用户主动确认支付之后，不得在静态导入或应用启动阶段触发渠道的信息处理。

2. 支付调用示例

以下为时序示意。privacyAccepted 与 paymentDisclosureAccepted 是应用自行管理的状态，不是 Ping++ API；应用须按实际处理依据及所需同意类型管理，不能用点击“支付”替代依法必需的单独同意。

import { Pingpp } from '@pingplusplus/pingppsdk';

// 仅在用户主动确认支付后执行。
// chargeJson 由可信业务服务端生成，且只含完成支付所需字段。
async function payAfterConsent(
  privacyAccepted: boolean,
  paymentDisclosureAccepted: boolean,
  chargeJson: string
) {
  if (!privacyAccepted || !paymentDisclosureAccepted) {
    return; // 应用显示相应告知或拒绝状态，不调用 SDK。
  }
  return await Pingpp.createPayment(chargeJson);
}

云闪付还需按包文档设置应用回跳 scheme。冷启动 onCreate 和热启动 onNewWant 应进入统一回调处理，使用 Pingpp.handlePaymentResult，不重新创建银联支付实例。微信回调应校验来源、按照官方 SDK 处理 Want。具体签名校验、来源校验及回调字段以实际渠道指南为准。

客户端结果用于 UI 展示；最终交易状态应以可信服务端查单或经过校验的 webhook 为准。生产日志应对支付对象及回调信息进行脱敏，避免记录完整凭证。

四、隐私政策与第三方 SDK 披露

为了向您提供支付宝、微信和云闪付 App 支付功能，我们集成了合作伙伴的软件工具开发包（简称“SDK”）。当您主动选择并使用相应支付方式时，相关 SDK 会为实现支付功能处理必要信息。第三方 SDK 信息如下。支付宝、微信、云闪付的信息处理按各自官方隐私规则统一披露，不按操作系统类型拆分；下表为渠道信息处理范围，不表示每次支付均处理全部所列信息：

开发者应在应用隐私政策及第三方 SDK 清单中，披露 Ping++ 及实际集成的支付渠道 SDK，并提供可访问的隐私政策链接。Ping++ 自身的披露示例见下文。

Ping++聚合支付SDK 披露示例

以下示例用于接入方应用的隐私政策或第三方 SDK 清单。开发者应在应用中同时展示第三方支付渠道清单，并将下方政策链接指向实际部署后的公开页面。

文字披露示例：

为向您提供支付宝、微信、银联云闪付 App 支付功能，我们接入上海简米网络科技有限公司提供的 Ping++聚合支付SDK（包名：@pingplusplus/pingppsdk）。当您选择支付渠道并主动确认支付时，该 SDK 会处理本应用传入的支付订单标识、渠道支付凭证及必要支付参数，向您所选渠道转交必要参数，并接收支付状态、错误码、结果说明及支付回调参数，以完成支付请求传递和结果反馈。Ping++ 聚合层不主动采集设备标识、位置、通讯录等客户信息，不申请或使用系统权限。支付过程中会打开您选择的支付 App；渠道 SDK 和支付 App 的信息处理详情见本应用第三方 SDK 清单及各渠道隐私规则。您可选择是否使用相应支付方式，不使用不会影响其他无关功能。

• 个人信息处理规则：Ping++聚合支付SDK 隐私政策。
• 提供方联系邮箱：cs@pingxx.com。

接入方应用引用隐私政策时，应使用可公开访问的 HTTPS 链接，并同步披露关联启动场景及各渠道具体信息字段。

微信支付配套规则与协议

微信 Open SDK 提供方为腾讯，微信支付服务提供方为财付通支付科技有限公司。开发者应分别披露微信 Open SDK 与财付通支付服务的信息处理范围。

• 财付通隐私政策：微信支付服务的信息处理规则。
• 微信支付用户服务协议（20260330版）：用户服务协议，不能代替隐私政策。
• 微信官网支付协议入口。
• 微信隐私保护指引：微信 App 本身的隐私规则。

云闪付 App 规则见云闪付隐私政策。实际开放华为 Pay 或其他额外渠道时，应同步补充相应服务、信息处理规则及路由配置。

五、授权同意、个人信息权利与安全

1. 授权同意

应用应提供清晰、易懂的隐私告知、完整政策入口和同意/拒绝选项。未同意或撤回后，不触发依赖该同意的 SDK/渠道处理；不影响其他无关功能。不得默认勾选、捆绑授权或以关闭按钮代替拒绝。

支付场景可提示：“您选择了【支付方式】，我们将向【接收方】提供【具体支付凭证/订单信息】并打开对应支付 App，以完成本次支付。请查看相关隐私规则。”应填写实际接收方、信息种类及有效链接。

如涉及敏感个人信息处理、向其他个人信息处理者提供个人信息或数据出境，并依法需要单独同意，应另行显著告知并取得单独同意，不能用同意应用总体隐私政策或普通支付点击替代。应告知敏感信息处理的必要性及对个人权益的影响；涉及不满十四周岁儿童时，取得监护人同意并履行适用保护义务。

Ping++ 聚合层不涉及主动采集金融账户信息或数据出境，不应因此推断整个支付服务无需单独授权。支付 App 内的金融账户、身份核验等处理由相应服务方依法告知授权；开发者仍需履行自身对应义务。

应用可保存最小必要的授权记录，用于核验政策版本、告知内容、同意时间及结果；其保存规则应由应用自身披露。

2. 最终用户权利

开发者应提供便于访问的隐私设置或客服入口，受理知情、决定、查阅、复制、更正、补充、删除、限制或拒绝处理、撤回同意等请求，并在符合法定条件时支持转移和规则解释。

Ping++ 聚合层无独立最终用户账号、用户资料库或数据访问、更正、删除接口，此类接口：不涉及。涉及应用或支付渠道实际持有信息的权利请求，应通过对应的信息管理或客服渠道处理。

撤回路径由应用实现：用户撤回后停止后续依赖同意的支付调用，不重复初始化或预热渠道。撤回不会自动撤销已完成交易，也不等于删除依法需保留的历史记录。支付数据的管理和删除路径以相应支付服务政策为准；微信登录授权管理适用于登录授权关系。

3. 安全要求

开发者应采用安全传输、访问控制、最小权限、日志脱敏及异常处理等措施，不得在日志中明文记录完整支付对象、支付凭证、密钥或金融账户信息。生产与测试应合理隔离，测试材料不应包含非必要的真实个人信息。客户端结果用于界面展示，交易最终状态应由可信服务端核验。发生相关安全事件时，应依法采取补救并履行适用的报告、通知及协助义务。

六、联系我们

如开发者或最终用户对 SDK 接入、信息处理或权利行使有疑问、意见、投诉或建议，可通过以下方式联系我们：

• 公司名称：上海简米网络科技有限公司。
• 电子邮箱：cs@pingxx.com。
• 联系地址：上海市浦东新区碧波路690号张江微电子港6号楼。
• 联系电话：021-5047 7566。
• 官网：Ping++。

在收到请求后15个工作日内回复。请仅提供处理请求所必需的材料，不要提交支付密码、验证码或完整支付凭证。