1. 接口规则

微卡收付通 API 的所有接口均通过 HTTPS 进行通信，提供高安全性的通信通道。并且均使用UTF-8编码。所有接口请求都涉及公共参数，公共参数需要统一放到 HTTP Header 请求头部中，具体请参考 公共参数 (opens in a new tab)。

开发者和微卡收付通通信包含：开发者请求微卡收付通、微卡收付通回调通知开发者，通信过程涉及签名和验签，整体流程如下：

2. 开发准备

2.1 搭建和配置开发环境

为了帮助开发者调用开放接口，我们提供了 JAVA、PHP、GO 三种语言版本的示例代码，封装了签名生成、签名验签 等基础逻辑。 在接口测试之前，需在微卡收付通管理后台 "开发者参数" 菜单 "生产环境" 获取 主体标识(ocode)、Secret ID、收付通公钥，并设置主体公钥。

请求微卡收付通测试步骤：

1. 拼接规范请求串 (opens in a new tab)
2. 拼接待签名字符串 (opens in a new tab)
3. 计算签名 (opens in a new tab)
4. 拼接Authorization (opens in a new tab)

以上为开发者请求微卡收付通的签名步骤伪代码，微卡收付通回调通知开发者的签名验签也采用相同算法和步骤，具体参考 回调验签 (opens in a new tab)。

签名和验签的具体实现代码参考 JAVA示例 (opens in a new tab)、PHP示例 (opens in a new tab)、GO示例 (opens in a new tab)。

2.2 业务开发配置

2.2.1 微卡收付通业务线支付通道资料配置

• 参考 配置业务线的通道资料

2.2.2 微卡收付通商户进件或录入支付通道资料

• 参考 配置收单商户

注：在未配置微卡收付通业务线资料和微卡收付通商户资料时，为了降低接口接入调试的门槛，可在沙箱环境发起相关接口对接调试，具体参考 沙箱环境调试 (opens in a new tab)。 沙箱环境的API地址和生产环境一致，区别在于开发者参数，需要在微卡收付通管理后台 "开发者参数" 菜单 "沙箱环境" 获取 主体标识(ocode)、Secret ID、收付通公钥，并设置主体公钥。

3. 快速接入

3.1 业务流程图

重点步骤说明：

• 步骤 1.4： 用户下单发起支付，开发者可通过 统一下单API (opens in a new tab) 创建支付订单。其中 PayType 参数传 **MINI_PROGRAM 表示小程序场景下单。
• 步骤 1.8： 开发者小程序根据微卡收付通返回的支付参数 PayInfoType、PayInfo 指引拉起支付面板。具体指引如下：

• 步骤 1.10： 用户支付成功后，开发者可接收到微卡收付通的支付结果通知，通知API参考 支付成功通知API (opens in a new tab)。
• 步骤 1.13： 开发者在没有收到微卡收付通支付结果通知的情况下需要主动调用 订单查询API (opens in a new tab)。由于支付通知可能存在延迟，以及通知在失败时微卡收付通只会尽最大努力重试有限次数，不可只依赖通知，开发者必须接入订单查询API作为兜底。