# 服务开通及技术集成

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

# 服务开通

包含两个环节，均需在微信公众平台完成：

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

详细的服务开通指引请参见 Tenpay Global 全球收银台服务开通手册 (腾讯文档 / Google Doc)

# 技术集成指引

下文介绍了全球收银台服务的主要集成内容及步骤，详细的开发者指引文档请参见 Tenpay Global Checkout API (腾讯文档 / Google Doc)

# 接口构成

• Tenpay Global 接口： 参见 Tenpay Global Checkout API (腾讯文档 / Google Doc) 中“3.接口说明”

  接口名称	调用链	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
  通知支付结果	Tenpay Global->商户	POST	通过 checkout-pay 的 notify_url 指定
  通知退款结果	Tenpay Global->商户	POST	通过 refund 的 notify_url 指定

• 小程序接口/对象： 参见 Tenpay Global Checkout API (腾讯文档 / Google Doc) 中“4.小程序集成”

  接口/对象名称	说明
  wx.createGlobalPayment	创建全球收银台对象
  globalPayment.openMethodPicker	拉起支付方式选择面板
  globalPayment.requestGlobalPayment	进入全球收银的支付页面
  globalPayment.methodKey	已选的支付方式

# 分场景集成

针对支付、退款、关闭订单、查询支付单、查询退款单和接收 Tenpay Global 通知等不同应用场景的集成指引，请参见 Tenpay Global Checkout API (腾讯文档 / Google Doc) 中“5.集成指引”

# 参与者关系

# 开发步骤

Step1:服务开通

登录微信公众平台，进入“全球收银台”，完成服务开通。服务开通指引请参见 Tenpay Global 全球收银台服务开通手册 (腾讯文档 / Google Doc)

开通完成后，进入“设置”模块上传商户 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：需要，任何时候都需要进行验签，确保获得的信息是来自官方的合法信息