Useepay SDK 使用说明

简介

这是一个用于对接收银台的SDK，旨在帮助开发者快速集成Useepay的支付功能。

对接流程图

对接支付方式说明

googlePay

注意

请确保在localhost或者https环境对接

applePay

注意

对接applePay需要先申请证书，出现applePay按钮的域名都需要申请证书（无论生产或测试）

提供域名后，将useepay提供的证书放置在指定位置并进行验证

只能在申请证书的域名下进行调试

目前支持的支付方式

快速开始

首先使用script标签引用Useepay的官方SDK：

通过验证是否成功在window挂载来进行下一步：

在进行支付时sdk需要一些必要的支付信息来初始化以及后续的支付：

你需要实现该方法来创建支付订单获取AccessToken用于后续的支付，该方法会在点击支付按钮后触发(具体的获取方法请点击跳转至文档)：

💡

/api/getAccessToken 为商户后端的接口，该接口需要调用UseePay create token ,接口获取token,注意调用该接口时autoRedirect参数设置为false.

示例getUseePayAccessToken请求（仅供参考）

我们提供了全局的支付结果回调方法，你可以通过payMethods设置全局成功和失败回调(可选)：

调用该方法并传入支付方式和要渲染的元素ID来创建支付方式：

你可以为支付实例设置独有的成功和失败的回调来处理支付中的问题以及支付结果(可选)：

在创建支付方式的时，会有不支持的情况，该方法帮助你处理不支持的情况(可选, 仅支持googlePay、applePay)：

你的应用场景如果需要修改支付的参数，你可以通过实现该方法来完成（可选）：

使用场景

常用于消费者用积分抵扣或者优惠券扣减订单总额的场景

注意

如果你没有修改金额和币种的需求，无需实现该方法

changeAmountAndCurrency会在点击按钮后获取最新的amount和currency

changeAmountAndCurrency默认返回{}

返回的对象中，amount和currency均为可选的String类型字段

如果返回的对象中，没有设置amount和currency，那么将使用createPaymentInfo中的值

确保changeAmountAndCurrency返回值的类型是对象

业务结果码（ResultCode）

注意

在处理paySuccess和payError时你需要关注支付的结果，根据ResultCode来进行相应的操作

参考：点击查看文档

Tips: 如果上面的步骤都已完成，那么恭喜你，你已经成功了！

检测支持的payMethods

说明：上面的被动校验方式可能不满足你的需求，因此我们提供了主动校验

注意（单独使用无需关注）

sdk在创建支付方式时内置了检测，因此请确保你在结合使用时能正确处理逻辑，以免产生冲突

综合检测，检测是否支持：

单独检测googlePay是否支持：

单独检测applePay是否支持：

1.0.0 内嵌方式对接 （建议使用“内嵌方式对接2.0.0”版本）

Useepay SDK 使用说明#

简介#

对接流程图#

对接支付方式说明#

目前支持的支付方式#

快速开始#

业务结果码（ResultCode）#

检测支持的payMethods#

1.0.0 内嵌方式对接（建议使用“内嵌方式对接2.0.0”版本）

Useepay SDK 使用说明

简介

对接流程图

对接支付方式说明

目前支持的支付方式

快速开始

业务结果码（ResultCode）

检测支持的payMethods