Useepay SDK 使用说明#
这是一个用于对接内嵌收银台的SDK,旨在帮助开发者快速集成Useepay的支付功能。证书说明#
ApplePay 证书#
ApplePay 内嵌方式对接需要在网站的路径下放ApplePay证书,请联系UseePay的运营获取该证书。1.
每个网站(区分二级域名)都需要放证书,证书有过期时间
2.
上线ApplePay证书,需要联系UseePay运营进行证书验证,否则无法正常处理交易
GooglePay证书#
测试说明#
对接流程图#
对接支付方式说明#
对接applePay需要先申请证书,出现applePay按钮的域名都需要申请证书(无论生产或测试)
提供域名后,将useepay提供的证书放置在指定位置并进行验证
目前支持的支付方式#
快速开始#
1.
首先使用script标签引用Useepay的官方SDK:
3.
在进行支付时sdk需要一些必要的支付信息来初始化以及后续的支付:
示例getUseePayAccessToken请求(仅供参考)上述代码中的response.data 参数示例:把调用UseePay create token 返回的所有参数放入resolve 中
{
resultCode: 'received',
token: 'mop:mapi:redis:50bcded0-a7e1-11ef-8163-a170e601bc8d',
errorCode: '',
errorMsg: ''
}
5.
我们提供了全局的支付结果回调方法,你可以通过payMethods设置全局成功和失败回调(可选):
6.
调用该方法并传入支付方式和要渲染的元素ID来创建支付方式:
7.
支付取消回调方法(可选, 仅支持googlePay、applePay):
8.
Click点击事件配置 (可选, 仅支持googlePay、applePay):
9.
你的应用场景如果需要修改支付的参数,你可以通过实现该方法来完成(可选):
常用于消费者用积分抵扣或者优惠券扣减订单总额的场景
changeAmountAndCurrency会在点击按钮后获取最新的amount和currency
changeAmountAndCurrency默认返回{}
返回的对象中,amount和currency均为可选的String类型字段
如果返回的对象中,没有设置amount和currency,那么将使用createPaymentInfo中的值
确保changeAmountAndCurrency返回值的类型是对象
10.
地址变更事件 (可选, 仅支持googlePay):
11.
运费变更事件 (可选, 仅支持googlePay):
业务结果码(ResultCode)#
在处理paySuccess和payError时你需要关注支付的结果,根据ResultCode来进行相应的操作
Tips: 如果上面的步骤都已完成,那么恭喜你,你已经成功了!检测支持的payMethods#
说明:上面的被动校验方式可能不满足你的需求,因此我们提供了主动校验sdk在创建支付方式时内置了检测,因此请确保你在结合使用时能正确处理逻辑,以免产生冲突
示例Demo#
此Demo仅供参考,具体的api使用方式和参数信息,请参考上述文档的详细介绍。
我们建议您先阅读文档,了解sdk的对接流程和注意事项再使用Demo。以便您更快速的接入。