客户端接入简介
在使用 Ping++ 接入 支付、订单、充值 时,你的用户需要在客户端唤起支付页面(如支付宝、微信等)并完成付款。使用 Ping++ Client SDK 可以方便、快速地完成这个步骤,一个完整的支付流程示例如下:
-
用户在客户端点击付款按钮时,弹出支付渠道列表(以你开通的支付渠道为准)。用户在选择其中一个支付渠道(如支付宝)后,客户端向服务端请求获取支付凭证。
-
服务端接收请求后通过 Ping++ Server SDK 生成支付凭证(Charge 对象、Order 对象、Recharge 对象),并将支付凭证以 JSON 字符串格式返回给客户端。
-
客户端获取到服务端传回的支付凭证后,通过 Client SDK 唤起支付页面。
-
此时,用户可以在唤起的支付页面完成付款。
-
一旦用户完成付款,Client SDK 会同步使用回调的方式告诉你的 APP 支付结果。
-
如果结果是支付成功,客户端再次请求服务端获取真实的最终支付结果(以服务端接收的 Webhooks 为准),或者由服务端直接处理后续发货逻辑。
我们提供了 Android、H5、iOS 三个版本的 Client SDK,根据你的 APP 的形态自主选择一个或多个完成接入。接入方式参考:
- 你的 APP 内的渠道选择页面和支付完成页面(布局、样式等)由你自行实现,可以使用我们标准 SDK 接入方式。在此接入方式下,你仅需要将支付凭证传给 Ping++ Client SDK,由 Ping++ Client SDK 完成唤起支付页面的功能。
注意事项
-
由于客户端网络不稳定、数据易篡改、安全性差等特点,请务必使用服务端的支付结果作为最终的发货凭证。
-
如果你的支付场景是扫码支付,你无需使用 Client SDK,仅需要将服务端传回的支付凭据内的链接展示为二维码即可。(链接转换成二维码由你自行实现)
-
微信 JSAPI 支付只能在微信浏览器内;微信浏览器外进行支付,可以使用微信 H5 支付;如果是 H5 封装的 APP 需要使用微信支付,请自行使用 webview 调用微信原生支付方式。
-
如果你的支付场景是手机网页或者 PC 网页支付,请参照 H5 SDK 接入指南 ,两者在申请支付渠道时有区分,不要混用。