客户端接入简介

在使用 Ping++ 接入 支付订单充值 时,你的用户需要在客户端唤起支付页面(如支付宝、微信等)并完成付款。使用 Ping++ Client SDK 可以方便、快速地完成这个步骤,一个完整的支付流程示例如下:

  1. 用户在客户端点击付款按钮时,弹出支付渠道列表(以你开通的支付渠道为准)。用户在选择其中一个支付渠道(如支付宝)后,客户端向服务端请求获取支付凭证。

  2. 服务端接收请求后通过 Ping++ Server SDK 生成支付凭证(Charge 对象、Order 对象、Recharge 对象),并将支付凭证以 JSON 字符串格式返回给客户端。

  3. 客户端获取到服务端传回的支付凭证后,通过 Client SDK 唤起支付页面。

  4. 此时,用户可以在唤起的支付页面完成付款。

  5. 一旦用户完成付款,Client SDK 会同步使用回调的方式告诉你的 APP 支付结果。

  6. 如果结果是支付成功,客户端再次请求服务端获取真实的最终支付结果(以服务端接收的 Webhooks 为准),或者由服务端直接处理后续发货逻辑。

我们提供了 Android、H5、iOS 三个版本的 Client SDK,根据你的 APP 的形态自主选择一个或多个完成接入。 无论是选择是哪个版本的 SDK,均含有以下两种接入方式:

  1. 你的 APP 内的渠道选择页面和支付完成页面(布局、样式等)由你自行实现,可以使用我们标准 SDK 接入方式。在此接入方式下,你仅需要将支付凭证传给 Ping++ Client SDK,由 Ping++ Client SDK 完成唤起支付页面的功能。

  2. 你的 APP 内的渠道选择页面和支付完成页面由 Ping++ Client SDK 实现,可以使用我们带有 UI 类库版本 SDK 接入方式。此时 Ping++ 会帮你生成这些页面,并完成后续的支付流程。注:该接入方式下,只有支付完成页是必选的(该页面上会展示 Ping++ 提供的广告信息)。

注意事项

  1. 由于客户端网络不稳定、数据易篡改、安全性差等特点,请务必使用服务端的支付结果作为最终的发货凭证。

  2. 如果你的支付场景是扫码支付,你无需使用 Client SDK,仅需要将服务端传回的支付凭据内的链接展示为二维码即可。(链接转换成二维码由你自行实现)

  3. 微信公众号支付只能在微信浏览器内;微信浏览器外进行支付,可以使用微信 H5 支付;如果是 H5 封装的 APP 需要使用微信支付,请自行使用 webview 调用微信原生支付方式。

  4. 如果你的支付场景是手机网页或者 PC 网页支付,请参照 H5 SDK 接入指南 ,两者在申请支付渠道时有区分,不要混用。

  5. 如果你正在使用的 Ping++ 广告版套餐,则必须使用 SDK 中带有 UI 类库版本的方式完成接入。

  6. UI 类库版本暂不支持 PC 类渠道支付。