USEEPAY V1.0
中文
  • 中文
  • English
UseePay官网
产品文档
  • V2.0版本
  • V1.0版本
收单商户平台
UseePay官网
产品文档
  • V2.0版本
  • V1.0版本
收单商户平台
中文
  • 中文
  • English
  1. 跳转式收银台接口
  • 全球收单
    • 产品说明
    • 集成模式
      • 跳转式收银台模式
      • 内嵌式收银台模式
      • 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 📌
            POST
          • credit_card
            POST
          • bancontact
            POST
          • boleto
            POST
          • giropay
            POST
          • Ideal
            POST
          • klarna
            POST
          • konbini
            POST
          • oxxo
            POST
          • payeasy
            POST
          • pix
            POST
          • sofort
            POST
        • 内嵌式收银台接口
          • 信用卡
            • 2.x 版本内嵌收银台
            • 内嵌订阅收银台
            • 版本更新说明
            • 1.x版本内嵌收银台
          • applepay & googlepay
            • 内嵌方式对接2.0.0
          • create token
        • 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. 跳转式收银台接口

cashier 接口说明

注意
关于预授权:
Ps:预授权完成最好在3个工作日内完成,否则万事达卡会被加收0.033欧元+0.28%的手续费,同时,超过3天的预授权拒付是无法申诉的。

cashier接口说明#

cashier是跳转式收银台的核心接口。
如果您希望通过跳转式收银台支持您网站的交易活动,您需要完成的核心内容只有两步:
【1】调用cashier接口,UseePay在响应中会返回一个收银台url(redirectUrl字段)
【2】向消费者展示该url对应的页面(即收银台),消费者将在此完成支付。

时序图#

时序图图解#

1. 发起支付请求阶段#

用户触发支付:用户在商户平台上点击“支付”按钮,正式发起支付请求,这是整个支付流程的起点,由用户主动触发交互。
商户调用支付接口:商户接收到用户的支付请求后,向UseePay Server调用/cashier接口,将用户的支付需求传递给支付服务端。

2. 收银台页面展示阶段#

支付服务端返回跳转链接:UseePay Server处理商户的接口请求后,向商户返回包含收银台页面地址的redirectUrl响应,为用户后续输入支付信息提供页面入口。
商户展示收银台页面:商户获取到redirectUrl后,将该链接对应的收银台页面展示给用户,使用户能够进入支付信息输入环节。

3. 支付信息提交与结果展示阶段#

用户输入支付信息并提交:用户在UseePay收银台页面中输入银行卡号(CardNo)、安全码(CVV)等支付相关信息,完成后点击支付按钮,向UseePay收银台提交支付确认请求。
收银台请求支付确认:UseePay收银台接收到用户的支付确认指令后,将该请求传递给UseePay Server,由服务端处理实际的支付流程。
支付服务端返回支付结果:UseePay Server完成支付处理后,向UseePay收银台返回支付结果,告知支付成功与否等信息。
收银台同步通知商户支付结果:UseePay收银台展示支付结果给用户的同时,通过同步调用商户的/cashier接口,将支付结果及相关的redirectUrl页面信息传输给商户,确保商户及时获取支付状态。

4. 异步通知阶段#

支付服务端异步通知商户:为进一步保障商户对支付结果的获取,UseePay Server通过异步调用商户的notifyUrl接口,再次将支付结果通知给商户,避免因同步通知异常导致商户信息缺失。
至此完成一次从用户发起支付到最终完成支付并通知商户的完整闭环。

请求参数对象说明#

payerInfo
参数必选类型说明
paymentMethodYstring传递您实际需要的支付方式,详情请查看文档【paymentMethod参数说明】
authorizationMethodYstring
  • cvv (普通交易)
  • threeds2.0 (3D)
AuthorizationMethod(用户授权方式:cvv/threeds1.0/threeds2.0): 这个字段生产环境传cvv,
当客户的卡 需要3ds时我们会动态转成3d。 只是对接测试的时候 可以根据自己需要的场景切换
cvv/threeds2.0。 threeds1.0现在我们不支持传,3d一般都走2.0流程,即使客户的卡只支持1.0,
我们也会自动降级的
billingAddressYJson String账单地址 (请根据交易类型:实物类交易/虚拟类交易传参)
firstNameNString(56)持卡人名(如果为空,则UseePay会用账单/收货地址姓名填充)
lastNameNString(56)持卡人名(如果为空,则UseePay会用账单/收货地址姓名填充)
threeDS2RequestDataN3ds请求参数
billingAddress 账单地址信息实物类交易)
billingAddress 账单地址信息虚拟类交易)
threeDS2RequestData对象参数说明
orderInfo
goodsInfo
shippingAddress 收货地址 ( 注:实物类交易必传,虚拟类交易非必传)
userInfo
修改于 2025-08-22 03:28:24
上一页
对象模型
下一页
paymentMethod参数说明
Built with