产品
商户管理
商户余额管理
开发指引

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 微卡收付通商户进件或录入支付通道资料

注:暂不支持沙箱

3. 快速接入

3.1 业务流程图

商户余额管理-开发指引-业务流程图

重点步骤说明:

步骤 1.1: 开发者可通过 查询商户余额API (opens in a new tab) 查询银行账户系统中子账户的余额,其中可用余额包含可提现余额。接口支持传入 商户ID、接收方ID或付款方ID查询余额。

步骤 1.3: 开发者可根据业务需要,调用 提现商户余额API (opens in a new tab) 将银行账户系统中子账户的可提现余额提出到子账户绑定的银行账号。接口支持传入 商户ID、接收方ID或付款方ID提现余额。

步骤 1.5 部分银行提现需要一定时间,提现商户余额接口会返回提现中,开发者可调用 商户提现查询API (opens in a new tab) 查询提现结果。


腾讯微卡开发者中心文档