# 服务开通及技术集成

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

## 服务开通

包含两个环节，均需在[微信公众平台](https://mp.weixin.qq.com)完成，详细的开通指引请参见[TenPay Global 全球收银台服务开通手册](https://www.tenpayglobal.com/docs/checkout/activate)：

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

## 技术集成指引

下文介绍了全球收银台服务的主要集成内容及步骤，详细的开发者指引文档请参见[TenPay Global 全球收银台 API 说明及集成指引](https://www.tenpayglobal.com/docs/checkout/integration)

### 接口构成
* **TenPay Global 接口：** 详情请参见[接口描述](https://www.tenpayglobal.com/docs/checkout/integration/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 指定 |

- **小程序接口/对象：** 详情请参见[小程序全球收银台对象](https://www.tenpayglobal.com/docs/checkout/integration/miniprogram)
  | 接口/对象名称 | 说明 |
  | --- | --- |
  | wx.createGlobalPayment | 创建全球收银台对象 |
  | globalPayment.openMethodPicker | 拉起支付方式选择面板 |
  | globalPayment.requestGlobalPayment | 进入全球收银的支付页面 |
  | globalPayment.methodKey | 已选的支付方式 |

### 分场景集成

针对支付、退款、关闭订单、查询支付单、查询退款单和接收 TenPay Global 通知等不同应用场景的集成指引，请参见[技术集成指引](https://www.tenpayglobal.com/docs/checkout/integration/guidance)

### 参与者关系

![](https://res8.wxqcloud.qq.com.cn/wxdoc/74d1158a-e9ca-48b6-b513-67e6856ab7e1.png)

### 开发步骤

**Step 1：服务开通**

登录[微信公众平台](https://mp.weixin.qq.com)，进入「全球收银台」，完成服务开通。服务开通指引请参见[TenPay Global 全球收银台服务开通手册](https://www.tenpayglobal.com/docs/checkout/activate)

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

**Step 2：开发**

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

**Step 3：验证**

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

**Step 4：放量**

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

> 开发过程如遇问题，可联系 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：需要，任何时候都需要进行验签，确保获得的信息是来自官方的合法信息