# 服务开通及技术集成

为使用全球收银台服务,商户需完成全球收银台服务开通及技术集成

# 服务开通

包含两个环节,均需在微信公众平台完成,详细的开通指引请参见 TenPay Global 全球收银台服务开通手册

  • 全球收银台功能开通: 向 TenPay Global 提交企业主体、受益人、业务联系人等信息,通过材料审核,以开通全球收银整体服务
  • 支付方式激活: 根据商户选择的支付方式要求,补充结算银行账户、业务问卷等资料,以激活所选支付方式

# 技术集成指引

下文介绍了全球收银台服务的主要集成内容及步骤,详细的开发者指引文档请参见 TenPay Global 全球收银台 API 说明及集成指引

# 接口构成

接口名称 调用链 Method 接口地址
支付预下单 商户->TenPay Global POST /api/payment/v1/checkout-pay
查询支付单 商户->TenPay Global POST /api/payment/v1/inquiry-payment
关闭订单 商户->TenPay Global POST /api/payment/v1/close-payment
申请退款 商户->TenPay Global POST /api/payment/v1/refund
查询退款单 商户->TenPay Global POST /api/payment/v1/inquiry-refund
通知支付结果 (WebHook) TenPay Global->商户 POST 通过checkout-pay的notify_url指定
通知退款结果 (WebHook) TenPay Global->商户 POST 通过refund的notify_url指定
  • 小程序接口/对象: 详情请参见小程序全球收银台对象
    接口/对象名称 说明
    wx.createGlobalPayment 创建全球收银台对象
    globalPayment.openMethodPicker 拉起支付方式选择面板
    globalPayment.requestGlobalPayment 进入全球收银的支付页面
    globalPayment.methodKey 已选的支付方式

# 分场景集成

针对支付、退款、关闭订单、查询支付单、查询退款单和接收 TenPay Global 通知等不同应用场景的集成指引,请参见技术集成指引

# 参与者关系

# 开发步骤

Step1:服务开通

登录微信公众平台,进入“全球收银台”,完成服务开通。服务开通指引请参见 TenPay Global 全球收银台服务开通手册

开通完成后,进入“设置”模块上传商户API证书 & 获取 TenPay Global 平台证书,以完成后续接口验签

Step2:开发

开发小程序前端拉起收银台功能、开发后台接口

Step3:验证

在 UAT 环境进行验证,最后迁移到生产验证

Step4:放量

验证完成后,开启对客放量

开发过程如遇问题,可联系 TenPay Global 全球收银台团队寻求技术支持

# 环境信息

# UAT 环境

域名统一为:https://uat.tenpayglobal.com

e.g.: checkout-pay 接口 UAT 域名为 https://uat.tenpayglobal.com/api/payment/v1/checkout-pay

# 生产环境

当商户成功入驻、配置密钥、开通支付方式后,可以使用正式的生产环境进行验证,具体地址请联系 TenPay Global 全球收银台团队提供

# FAQ

Q:对于通知接口,商户是否需要验签?

A:需要,任何时候都需要进行验签,确保获得的信息是来自官方的合法信息