1. 接口规则
微卡收付通 API 的所有接口均通过 HTTPS 进行通信，提供高安全性的通信通道。并且均使用UTF-8编码。所有接口请求都涉及公共参数，公共参数需要统一放到 HTTP Header 请求头部中，具体请参考 公共参数 (opens in a new tab)。
开发者和微卡收付通通信包含：开发者请求微卡收付通、微卡收付通回调通知开发者，通信过程涉及签名和验签，整体流程如下：
2. 开发准备
2.1 搭建和配置开发环境
为了帮助开发者调用开放接口，我们提供了 JAVA、PHP、GO 三种语言版本的示例代码，封装了签名生成、签名验签 等基础逻辑。 在接口测试之前，需在微卡收付通管理后台 "开发者参数" 菜单 "生产环境" 获取 主体标识(ocode)、Secret ID、收付通公钥，并设置主体公钥。
请求微卡收付通测试步骤：
- 拼接规范请求串 (opens in a new tab)
- 拼接待签名字符串 (opens in a new tab)
- 计算签名 (opens in a new tab)
- 拼接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 微卡收付通商户进件或录入支付通道资料
- 参考 配置收单商户
注：暂不支持沙箱
3. 快速接入
3.1 业务流程图
重点步骤说明：
步骤 1.1： 支付成功后自动分账，开发者可通过 统一下单API (opens in a new tab) 创建支付订单时，携带分账参数 ProfitShareInfoList。支付成功后，微卡收付通会根据接收方账期设置进行自动分账，此时的账期从订单支付成功日开始计算。
步骤 1.4： 开发者可在订单支付成功后根据实际业务需要，选择在合适的时机发起分账，可调用 请求分账API (opens in a new tab)进行分账。微卡收付通会根据接收方账期设置进行分账，此时的账期从请求分账日开始计算。
步骤 1.8： 开发者可主动调用 查询分账API (opens in a new tab)查询分账结果。当传入参数OutProfitOrderId表示查询主动调用分账的结果，当传入参数OutOrderId表示查询下单支付中传入分账参数自动分账的结果。若同时传入两者，则视为OutProfitOrderId有效。
注：退分账流程和分账流程类似，支持在订单退款申请API (opens in a new tab)中传入ProfitShareInfoList自动退分账，也可通过调用请求退分账API (opens in a new tab)主动退分账。