微信支付接口说明书

微信支付说明书

V1.0 2016年04月

修订页

编号 1 2 3 章节名称 全文 交易回调通知 修订内容简述 创建全文 通知交易状态 修订日期 2016年04月16日 2016年04月28日 修订前 修订后版本号 版本号 V1.0 曾军 曾军 曾军 修订人 批准人 同步商户签约费率 同步商户签约费率 2016年06月01日

二维码支付接口说明书

1.1. 接口说明

通过http post方式交互，请求报文为json格式，请求报文由商户号、交易命令、交易信息、signature(签名)组成，交易信息的内容需加签，整个交易信息需要进行加密，返回格式为json。

1.2. 数据流程

客户端处理流程

1. 拼装报文，对msg字段加签放入signature字段中 2. 对拼装后报文加密并发送 3. 接收服务器响应，解密 4. 对于接收的报文验证签名。

1.3. 安全说明

报文会对敏感字段（msg）进行MD5WITHRSA签名，并对整个报文RSA加密，加密说明见相关demo。

1.4. 数据类型规则 1.4.1. 出现次数

1) 2) 3) 4)

0..1——数据元值域可填，且出现一次，节点中必须出现，可空； 0..n——数据元值域可填，且可出现多次； 1..1——数据元值域必填，且出现一次； 1..n——数据元值域必填，且可出现多次

1.4.2. 节点数据类型

1) s=字符类型，例：s..60 字符串60个长度

2) n=数值类型，例：n..18,4 数值包含小数点共18位，其中包含4位小数 3) date=日期类型，全文要求日期格式为 yyyyMMddHHmmss

1.4.3. 相关数据详解

1) 时间字段：时间字段如无特殊说明，则格式为yyyyMMddHHmmss

二维码支付接口说明书

1.5. 交易码列表 1.5.1. 基础功能

序号 1. 2. 3. 4. 5. 交易命令 register tb_DownLoadKey tb_verifyInfo tb_WeixinPay 代码功能 注册普通POST HTTP方式请求详见Demo 下载密钥 验卡 二维码支付 tb_OrderConfirm 查询订单状态 注意：2.3.4.5 接口全部按照加密传输;

加密格式为：{\"data\":\"加密信息\签名\

加密信息：{\"msg\":\"{\"参数\":\"\

1.6. 接口信息说明 1.6.1. 注册商户接口

请求报文：

序号 1 2 3 4 中文名称 帐号 密码 推广码 下放商户标识 字段名称 account pass code cbzid 出现次数 数据类型及长度 1..1 1..1 1..1 1..1 s..11 s..6 s..6 s..50 说明 手机号码 必填 >=6位(英文/数字) 必填 按照下放信息填写 必填 按照下放信息填写 必填 备注：普通HTTP POST交互,详见demo;

推广码和下放商户标识必须填写下放资料里面对应的信息;

响应报文

序号 1 2

标记 respCode respInfo 中文名称 返回码 c 出现次数 1..1 1..1 数据类型及长度 说明 s..5 s..60 详见返回码说明

二维码支付接口说明书

1.6.2. 下载密钥接口(tb_DownLoadKey)

请求报文

序号 1 2 3 标记 orderCode account password 中文名称 交易命令 帐号 密码 出现次数 1..1 1..1 1..1 数据类型及长度 s..5 s..11 s..6 说明 必填 必填 必填 响应报文

序号 1 2 3

标记 respCode respInfo 中文名称 返回码 返回码描述 私钥 出现次数 1..1 1..1 1..1 数据类型及长度 s..5 s..5 s..800 说明 详见返回码说明 签名信息，解密信息 privatekey 1.6.3. 验卡接口(tb_verifyInfo)

请求报文

序号 1 2 3 4 5 6 7 8 9 11 12 13 14 15 16

标记 orderCode account real_name cmer card_type card_no cert_type cert_no mobile location cert_correct cert_opposite cert_meet card_correct card_opposite 中文名称 交易命令 帐号 户名 商户名称 卡类型 卡号 证件类型 证件号 开户时绑定手机号 开户城市 身份证正面图片 身份证背面图片 手持身份证图片 银行卡正面图片 银行卡背面图片 出现次数 数据类型及长度 1..1 1..1 1..1 1..1 1..1 1..1 1..1 1..1 1..1 1..1 1..1 1..1 1..1 1..1 1..1 s..5 s..11 s..4 s..10 s..1 s..30 s..1 s..30 s..11 s..10 s..20 s..20 s..20 s..20 s..20 说明 必填 必填 真实姓名 必填 必填 参考demo默认值必填 只允许个人卡号必填 参考demo默认值必填 必填 非必填 非必填 图片地址 非必填 图片地址 非必填 图片地址 非必填 图片地址 非必填 图片地址 非必填

二维码支付接口说明书

响应报文

序号 1 2

标记 respCode respInfo 中文名称 返回码 返回码描述 出现次数 1..1 1..1 数据类型及长度 s..5 s..50 说明 详见返回码说明 1.6.4. 二维码支付接口(tb_WeixinPay)

请求报文

序号 1 1 2 3

标记 orderCode account amount info 中文名称 交易命令 帐号 金额 备注 出现次数 1..1 1..1 1..1 1..1 数据类型及长度 s..5 s..50 s..50 s..50 说明 必填 必填 单位：分必填 附加信息默认为空 非必填 响应报文

序号 1 2 3

标记 respCode orderId 中文名称 返回码 订单号 出现次数 数据类型及长度 1..1 1..1 1..1 s..5 s..70 s..10 说明 详见返回码说明 QRcodeURL 二维码支付地址

二维码支付接口说明书

1.6.5. 订单状态查询接口(tb_OrderConfirm)

请求报文

序号 1 2 3 标记 orderCode account orderId 中文名称 交易命令 帐号 订单号 出现次数 1..1 1..1 1..1 数据类型及长度 s..5 s..11 s..15 说明 必填 必填 交易接口返回的orderId必填 响应报文

序号 1 2 3 标记 respCode respInfo orderId 中文名称 返回码 返回码描述 订单号 出现次数 1..1 1..1 1..1 数据类型及长度 说明 s..5 s..50 s..15 详见返回码说明

1.6.6.交易回调通知返回信息

序号 1 2 3 标记 orderId respCode respInfo 中文名称 订单号 返回码 返回码描述 出现次数 1..1 1..1 1..1 数据类型及长度 说明 s..5 s..50 s..15 注意：发送方式普通POST表单，request 接收;

1.6.7. 同步商户签约费率(xy_ChangeRate)

请求报文

序号 1 2

标记 orderCode account 中文名称 交易命令 帐号 出现次数 1..1 1..1 数据类型及长度 s..5 s..11 说明 必填 必填 二维码支付接口说明书

3 4 5 password rate cbzid 密码 签约费率 下发商户标识 1..1 1..1 1..1 s..11 s..5 s..11 必填 必填[例如：0.005]千分比 必填 响应报文

序号 1 2 标记 respCode respInfo 中文名称 返回码 返回码描述 出现次数 1..1 1..1 数据类型及长度 说明 s..5 s..50 详见返回码说明

1.7. 返回码及描述

响应码 100022 100011 100015 100016 100034 100035 300000 100036 100037 100038 100039 100040 100043 100001 100002 100003 100000 100089 100032 100026 100027 100050

响应信息 ERRORCBZID ERRORCODE ERRORALREADYREGISTERED ERROR ERRORDECRYPT ERRORCHECKCARD ERRORAUDIT ERROR ERRORAUDITING ERRORSYNC ERRORDECRYPT ERRORCHECKCARD ERROR ERRORNOTAUDITED ERRORNOCHECKCARD ERRORCHANNELRSA ERROR ERRORORDER ERROR ERRORNOTEXISTORPASS ERROR ERRORPARAMS 备注 cbzid错误 推荐码错误 账号已经注册 注册系统异常 解密失败 验卡失败 审核失败 验卡系统异常 审核中不允许修改 同步中不允许修改 解密失败 验卡失败 验卡系统异常 商户未审核 商户未验卡 密钥错误 交易系统异常 订单号错误 订单确认系统异常 商户不存在或者密码错误 获取密钥系统异常 信息有误 二维码支付接口说明书

100052 100054 100055 000000 ERRORRATE ERRORJCMSTATE ERROR SUCCESS 签约费率错误 商户未审核 同步商户签约费率异常 成功

1.8. 对账文件 1.8.1.对账文件说明

服务器每日9：00—10：00生成前一日的对账文件，对账文件采用txt 的格式记录。每个txt文件，从第1行到第N行(N>=1)是对账明细。对账明细元素之间采用|分割。

1.8.2. 对账文件格式

采用txt文件，文件的格式如下

商户号|商户订单号|交易金额|商户费率|商户手续费|实付金额|交易状态|清算状态|交易时间|清算时间

1.8.3. 对账文件获取方式

通过邮件的方式接收；