> For the complete documentation index, see [llms.txt](https://payment.gitbook.io/mpay/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://payment.gitbook.io/mpay/master.md).

# 概述

**前言**

供手机支付开发人员与商户平台服务方技术或业务人员参考和查询。测试账号请联系客服人员。

**文档说明**

**接口说明**

通过 `http post` 的方式交互，请求报文为 `json` 格式，请求报文由版本号、商户 号、交易信息、 sign(签名)组成，交易信息的内容需加签，详情见签名说明。

**文档修订**

| 版本号 |    修改日期    |   变更者   | 变更说明        |
| :-: | :--------: | :-----: | ----------- |
| 1.1 | 2018.10.23 | Tinywan | 增加点点支付开发者文档 |
| 1.0 |  2018.9.29 | Tinywan | 重写聚合支付开发者文档 |

**通讯说明**

> 对于客户段请求使用`http post` 形式进行通讯，接口中的字段名称与值大小写敏感。
>
> > 1. 对 `content` 属性的所有字段按照 `key=value` 的格式，并按照 ASCII 字典排 序。进行`urlencode`编码，生成：`值1`
> > 2. 将`值1`加上 `&key=qwertyuiasdfghjklzxcvbnmp1234567`，拼接成：`值2`
> > 3. MD5(`值1`)，生成加签`值3` 即为 `sign` 值，需要把`sign`转换为小写
> > 4. 最后将结果设值到 `sign` 属性中用 `http post` 方式上传至服务器

**错误码**

> 网关会对开发者的接口非业务调用错误做统一处理
>
> ## 备注
>
> * [**https://xxx.com/api/gateway**](https://xxx.com/api/gateway) **不作为接口调试的Api请求地址，具体地址以实际开发为准。**

**公共错误码**

| code（返回码） | msg（返回码描述）      | 描述                |
| --------- | --------------- | ----------------- |
| 0         | 请求成功            | 请求成功              |
| -1        | 系统繁忙            | 系统繁忙              |
| 20000     | 服务不可用           | 服务暂不可用（网关自身的未知错误） |
| 40001     | 缺少必选参数          | 请求参数里面必须要有参数      |
| 40002     | 请求方法不存在         | method 不存在        |
| 40003     | 签名错误            | 请检查签名             |
| 40004     | 商户不存在           | 商户不存在             |
| 40005     | 商户已被停用          | 商户已被停用            |
| 40006     | 商户资料未认证         | 商户资料未认证           |
| 40007     | 子商户不存在          | 子商户不存在            |
| 45009     | 接口调用超过限制        | -                 |
| 46001     | 手续费账户余额不足       | -                 |
| 46002     | 提现支付宝账号未设置，请先设置 | -                 |
| 46003     | 提现支付宝账号不存在      | -                 |
| 46004     | 提现支付宝账号未启用      | -                 |
| 46001     | 手续费账户余额不足       | -                 |
| 46001     | 手续费账户余额不足       | -                 |

**业务错误码**

| code（返回码） | msg（返回码描述） | 描述   |
| --------- | ---------- | ---- |
| 0         | 请求成功       | 请求成功 |

**银行编号**

| 银行编码     | 银行名称   |
| -------- | ------ |
| 01020000 | 工商银行   |
| 01050000 | 建设银行   |
| 01030000 | 农业银行   |
| 03080000 | 招商银行   |
| 03010000 | 交通银行   |
| 01040000 | 中国银行   |
| 03030000 | 光大银行   |
| 03050000 | 民生银行   |
| 03090000 | 兴业银行   |
| 03020000 | 中信银行   |
| 03060000 | 广发银行   |
| 03100000 | 浦发银行   |
| 03070000 | 平安银行   |
| 03040000 | 华夏银行   |
| 04083320 | 宁波银行   |
| 03200000 | 东亚银行   |
| 04012900 | 上海银行   |
| 01000000 | 中国邮储银行 |
| 04243010 | 南京银行   |
| 65012900 | 上海农商行  |
| 03170000 | 渤海银行   |
| 64296510 | 成都银行   |
| 04031000 | 北京银行   |
| 64296511 | 徽商银行   |
| 04341101 | 天津银行   |