USEEPAY V1.0
中文
  • 中文
  • English
UseePay官网
产品文档
  • V2.0版本
  • V1.0版本
收单商户平台
UseePay官网
产品文档
  • V2.0版本
  • V1.0版本
收单商户平台
中文
  • 中文
  • English
  1. applepay & googlepay
  • 全球收单
    • 产品说明
    • 集成模式
      • 跳转式收银台模式
      • 内嵌式收银台模式
      • Direct API模式
      • 插件模式
    • 集成之前
      • 开始之前(必读)📘
      • 在SandBox中集成接口
      • 在Prod中上线服务
      • 请求签名指南
        • 加签/验签Demo
        • 加签/验签机制
    • 开始集成
      • UseePay规范
        • 业务结果码(ResultCode)
        • 错误码(ErrorCode)
        • 货币单位和金额规范
        • 国家信息规范
      • 接口集成📗
        • 对象模型
        • 跳转式收银台接口
          • cashier 接口说明
          • paymentMethod参数说明
          • googlepay
            • GoogePay须知
            • googlepay
          • applepay
            • 判断当前设备是否支持applepay
            • applepay
          • wechat_native
            • 关于微信退款
            • wechat_native - 微信扫码支付
          • wechat_h5
            • 关于微信退款
            • wechat_h5 - H5支付
          • cashier 📌
          • credit_card
          • bancontact
          • boleto
          • giropay
          • Ideal
          • klarna
          • konbini
          • oxxo
          • payeasy
          • pix
          • sofort
        • 内嵌式收银台接口
          • 信用卡
            • 2.x 版本内嵌收银台
            • 内嵌订阅收银台
            • 版本更新说明
            • 1.x版本内嵌收银台
          • applepay & googlepay
            • 内嵌方式对接2.0.0
          • create token
            POST
        • Direct API接口
          • googlepay
            • GoogePay须知
            • googlepay
          • applepay
            • 判断当前设备是否支持applepay
            • ApplePay API接入流程
            • ApplePay API接入流程备份
            • ApplePay Merchant Identifier
            • applepay
            • ApplePay商户Session
          • wechat_native
            • 关于微信退款
            • wechat_native - 扫码支付
          • wechat_jsapi
            • 关于微信退款
            • 小程序支付
            • 微信公众号支付
            • wechat_jsapi - 微信原生支付
          • konbini
          • payeasy
          • klarna
          • alipay
          • alipay_cn/alipay_hk
          • giropay
          • sofort
          • Ideal
          • boleto
        • 订单相关接口
          • 订单通用接口
            • 订单查询Query
            • 订单退款Refund
            • 订单预授权完成(Capture)
            • 订单预授权撤销(Void)
          • 拒付接口
            • 拒付流程说明
            • 拒付查询
          • 通知接口
            • 交易通知
              • 同步/异步通知
              • webhook版本升级一览
              • webhook
            • 拒付通知
              • 拒付webhook
          • 物流接口
            • 物流信息上传 2.1版
            • 物流信息查询 2.1版
          • 订单数据拉取 - SFTP
            • SFTP
      • 测试资源-SandBox
        • UseePay测试卡💳
        • 信用卡测试案例
        • 本地化测试案例
        • ApplePay&& Google Pay测试用例
        • 退款测试案例
      • 插件集成
        • Shopify(直连内嵌收银台)
        • Shopify(跳转收银台 & Google pay & Apple pay)
        • Shopify(本地化 & Google pay & Apple pay)
        • Shoplazza店匠
        • Shopline
        • Shopline(Google pay & Apple pay)
        • AllValue有赞
        • Shopexpress微盟
        • Shopyy
        • Xshoppy
        • 2cshop
        • Meshop
        • UEESHOP
        • FPP
        • Shopbase(暂停使用)
        • Shoptop
        • Shopastro
        • Magento
        • Woocommerce/WordPress
        • OpenCart
        • PapPal支付绑定
        • Alipay支付绑定
        • 万全云
        • Fecify
        • magento - Wechat/Alipay/UseePay Payments
        • shopify其他
          • Afterpay分期付款组件展示
          • Googlepay&Applepay名称修改
          • 如何增加卡组织logo
          • UseePay商户订单号匹配Shopify店铺订单
    • MC收单平台操作手册
      • 商户号查找
      • Appld查找
      • 域名添加
      • 域名证明下载
      • Shopify-SecurityKey查找
      • 密钥查找
      • 交易订单查找
      • 订单失败原因查看
      • 退款查询
      • 退款处理
      • ARN查询方式
      • 银行账号添加
      • 提现操作
      • 黑名单添加
      • 白名单添加
      • 新增操作员设置
      • 添加邮箱提醒
      • 物流上传
      • 对账单下载&查询
      • 争议订单处理
      • 拒付处理
      • 拒付预警处理
      • 重置密码
    • 附录
      • 本地化汇总
      • FAQ
        • 常见问题解答
        • 集成和认证
        • ueeshop配置常见错误
        • ApplePay常见问题
        • 支付和预授权的区别
      • 过期文档
        • applepay&googlepay 内嵌1.0.0
        • 参数对象说明(过期)
  • 数据模型
    • 示例数据模型
      • Pet
      • OrderInfo
      • Category
      • Tag
  1. applepay & googlepay

内嵌方式对接2.0.0

Useepay SDK 使用说明#

简介#

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

证书说明#

ApplePay 证书#

ApplePay 内嵌方式对接需要在网站的路径下放ApplePay证书,请联系UseePay的运营获取该证书。
1.
每个网站(区分二级域名)都需要放证书,证书有过期时间
2.
上线ApplePay证书,需要联系UseePay运营进行证书验证,否则无法正常处理交易

GooglePay证书#

googlepay 内嵌方式无需证书

测试说明#

请参考
https://openapi-useepay.apifox.cn/doc-3829773#apple-pay

对接流程图#

image.png

对接支付方式说明#

1.
googlePay
注意
请确保在localhost或者https环境对接
2.
applePay
注意
对接applePay需要先申请证书,出现applePay按钮的域名都需要申请证书(无论生产或测试)
提供域名后,将useepay提供的证书放置在指定位置并进行验证
只能在申请证书的域名下进行调试
请在沙盒环境完成测试后再上线

目前支持的支付方式#

快速开始#

1.
首先使用script标签引用Useepay的官方SDK:
2.
通过验证是否成功在window挂载来进行下一步:
3.
在进行支付时sdk需要一些必要的支付信息来初始化以及后续的支付:
4.
你需要实现该方法来创建支付订单获取AccessToken用于后续的支付,该方法会在点击支付按钮后触发(具体的获取方法请点击跳转至文档:
提示
该操作需要在20s内完成,超时将以失败处理!
示例getUseePayAccessToken请求(仅供参考)
💡
/api/getAccessToken 为商户后端的接口,该接口需要调用 create token,接口获取token,注意调用该接口时autoRedirect参数设置为false.
上述代码中的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):
提示
该操作需要在1s内完成,超时将以失败处理!
9.
你的应用场景如果需要修改支付的参数,你可以通过实现该方法来完成(可选):
使用场景
常用于消费者用积分抵扣或者优惠券扣减订单总额的场景
注意
如果你没有修改金额和币种的需求,无需实现该方法
changeAmountAndCurrency会在点击按钮后获取最新的amount和currency
changeAmountAndCurrency默认返回{}
返回的对象中,amount和currency均为可选的String类型字段
如果返回的对象中,没有设置amount和currency,那么将使用createPaymentInfo中的值
确保changeAmountAndCurrency返回值的类型是对象
10.
地址变更事件 (可选, 仅支持googlePay):
11.
运费变更事件 (可选, 仅支持googlePay):

业务结果码(ResultCode)#

注意
在处理paySuccess和payError时你需要关注支付的结果,根据ResultCode来进行相应的操作
参考:业务结果码
Tips: 如果上面的步骤都已完成,那么恭喜你,你已经成功了!

检测支持的payMethods#

说明:上面的被动校验方式可能不满足你的需求,因此我们提供了主动校验
注意(单独使用无需关注)
sdk在创建支付方式时内置了检测,因此请确保你在结合使用时能正确处理逻辑,以免产生冲突
1.
综合检测,检测是否支持:
2.
单独检测googlePay是否支持:
3.
单独检测applePay是否支持:

示例Demo#

注意
此Demo仅供参考,具体的api使用方式和参数信息,请参考上述文档的详细介绍。
我们建议您先阅读文档,了解sdk的对接流程和注意事项再使用Demo。以便您更快速的接入。
修改于 2025-10-17 08:06:54
上一页
1.x版本内嵌收银台
下一页
create token
Built with