微信支付接口说明书.docx

二维码支付接口说明书 PAGE 微信支付说明书 V1.0 2016年04月 修订页 编号 章节名称 修订内容简述 修订日期 修订前 版本号 修订后版本号 修订人 批准人 1 全文 创建全文 2016年04月16日 V1.0 曾军 2 交易回调通知 通知交易状态 2016年04月28日 曾军 3 同步商户签约费率 同步商户签约费率 2016年06月01日 曾军 接口说明 通过http post方式交互，请求报文为json格式，请求报文由商户号、交易命令、交易信息、signature(签名)组成，交易信息的内容需加签，整个交易信息需要进行加密，返回格式为json。 数据流程 客户端处理流程 拼装报文，对msg字段加签 放入signature字段中 对拼装后报文加密并发送 接收服务器响应，解密 对于接收的报文验证签名。 安全说明 报文会对敏感字段（msg）进行MD5WITHRSA签名，并对整个报文RSA加密，加密说明见相关demo。 数据类型规则 出现次数 0..1——数据元值域可填，且出现一次，节点中必须出现，可空； 0..n——数据元值域可填，且可出现多次； 1..1——数据元值域必填，且出现一次； 1..n——数据元值域必填，且可出现多次 节点数据类型 s=字符类型，例：s..60 字符串60个长度 n=数值类型，例：n..18,4 数值包含小数点共18位，其中包含4位小数 date=日期类型，全文要求日期格式为 yyyyMMddHHmmss 相关数据详解 时间字段：时间字段如无特殊说明，则格式为yyyyMMddHHmmss 交易码列表 基础功能 序号 交易命令 代码功能 register 注册普通POST HTTP方式请求详见Demo tb_DownLoadKey 下载密钥 tb_verifyInfo 验卡 tb_WeixinPay 二维码支付 tb_OrderConfirm 查询订单状态 注意： 接口全部按照加密传输; 加密格式为：{data:加密信息,signature:签名} 加密信息：{msg:{参数:,}} 接口信息说明 注册商户接口 请求报文： 序号 中文名称 字段名称 出现次数 数据类型及长度 说明 1 帐号 account 1..1 s..11 手机号码 必填 2 密码 pass 1..1 s..6 =6位(英文/数字) 必填 3 推广码 code 1..1 s..6 按照下放信息填写 必填 4 下放商户标识 cbzid 1..1 s..50 按照下放信息填写 必填 备注：普通HTTP POST交互,详见demo; 推广码和下放商户标识必须填写下放资料里面对应的信息; 响应报文 序号 标记 中文名称 出现次数 数据类型及长度 说明 1 respCode 返回码 1..1 s..5 详见返回码说明 2 respInfo c 1..1 s..60 下载密钥接口(tb_DownLoadKey) 请求报文 序号 标记 中文名称 出现次数 数据类型及长度 说明 1 orderCode 交易命令 1..1 s..5 必填 2 account 帐号 1..1 s..11 必填 3 password 密码 1..1 s..6 必填 响应报文 序号 标记 中文名称 出现次数 数据类型及长度 说明 1 respCode 返回码 1..1 s..5 详见返回码说明 2 respInfo 返回码描述 1..1 s..5 3 privatekey 私钥 1..1 s..800 签名信息，解密信息 验卡接口(tb_verifyInfo) 请求报文 序号 标记 中文名称 出现次数 数据类型及长度 说明 1 orderCode 交易命令 1..1 s..5 必填 2 account 帐号 1..1 s..11 必填 3 real_name 户名 1..1 s..4 真实姓名 必填 4 cmer 商户名称 1..1 s..10 必填 5 card_type 卡类型 1..1 s..1 参考demo默认值 必填 6 card_no 卡号 1..1 s..30 只允许个人卡号 必填 7 cert_type 证件类型 1..1 s..1 参考demo默认值 必填 8 cert_no 证件号 1..1 s..30 必填 9 mobile 开户时绑定手机号 1..1 s..11 非必填 11 location 开户城市 1..1 s..10 非必填 12 cert_correct 身份证正面图片 1..1 s..20 图片地址 非必填 13 cert_opposite 身份证背面图片 1..1 s..20 图片地址 非必填 14 cert_meet 手持身份证图片 1..1 s..20 图片