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 微卡收付通业务线支付通道资料配置
- 参考 配置业务线的通道资料
注：暂不支持沙箱
3. 快速接入
3.1 业务流程图（收单进件）
重点步骤说明：
步骤 1.1： 开发者调用 商户资质文件上传API (opens in a new tab) 上传资质文件。上传成功后接口响应中的ChannelApplyId将用于进件申请接口中资质文件的入参。
步骤 1.3： 开发者调用 商户线上进件API (opens in a new tab) 发起进件申请。申请成功后，微卡收付通将异步继续处理进件流程。必要时，微卡收付通系统会以短信的形式将相关签约链接发送给进件商户的联系人进行填写。
步骤 1.5： 进件申请成功后，开发者可通过 商户进件结果查询API (opens in a new tab) 查询进件结果。由于进件通知可能存在延迟，以及通知在失败时微卡收付通只会尽最大努力重试有限次数，不可只依赖通知，开发者必须接入商户进件结果查询API作为兜底。
步骤 1.7： 开发者如果在商户线上进件API中传入进件结果通知地址NotifyUrl，微卡收付通将会在进件成功时通知开发者。通知API参考商户进件结果通知API (opens in a new tab)
3.2 业务流程图（银行账户系统进件）
如果业务需要使用银行账户系统开展 商户号分账到子账户 业务，可参考该业务流程图组织相关接口接入。银行账户系统进件主流程和收单进件相同，会调用 商户资质文件上传API、商户线上进件API、商户进件结果查询API、商户进件结果通知API等接口。除此之外，银行账户系统进件涉及绑卡和绑卡验证等流程，因此在进件流程中会根据不同进件状态或不同银行通道接入相关接口。具体流程如下：
重点步骤说明：
步骤 1.5 开发在调用 1.4 查询进件结果 为进件成功后，通过调用 查询绑卡API (opens in a new tab) 获取绑卡状态，如果绑卡成功，则整个进件流程结束。
步骤 1.8 如果商户未收到银行小额打款，则调用 查询绑卡API (opens in a new tab) 获取失败原因，根据 1.9 检查信息 执行下一步操作。
步骤1.10 在 1.6或1.9查询绑卡失败、1.7未收到银行小额打款、1.11未收到短信验证码 等情况，都可以根据情况主动调用 绑卡API (opens in a new tab) 重新进行绑卡。
步骤1.13 商户收到银行小额打款和短信验证码后，将打款金额和验证码告知开发者系统，开发者调用 确认绑卡API (opens in a new tab) 完成绑卡确认，确认成功则结束整个进件流程，确认失败则重新 "确认绑卡" 或 "绑卡"。