@ulodev
2019-08-02T06:16:51.000000Z
字数 13935
阅读 5001
接口
| 版本号 | 更新说明 | 日期 | 作者 |
| V1.0 | 文档初次创建 | 2017/07/18 | 优络服务技术 |
| V1.0.1 | 删除商户基本信息中的settleStyle(结算方式)参数 | 2017/08/08 | 优络服务技术 |
| V1.0.2 | 新增银行代号表,缺失银行可以向优络服务技术提出,可配置 | 2017/08/11 | 优络服务技术 |
| V1.0.3 | 支付类型(payCenters)新增第三方APPID(thirdAppid)字段,使用微信原生公众号支付接口,需要传该字段 | 2017/08/14 | 优络服务技术 |
| V1.0.4 | 新增商户资料上传接口Demo,点我下载(Java开发语言),Demo比较简单,仅供参考 | 2017/08/16 | 优络服务技术 |
| V1.0.4 | payCenters(商户支付中心)增加providerNo字段。非必传,银行为服务商申请的渠道标识 | 2017/11/14 | 优络服务技术 |
| V1.0.5 | 添加商户接口返回参数新增platMchNo字段,查询商户接口字段修改,uloMchNo改为platMchNo, 该字段为优络给商户分配的商户编号,调统一支付接口时会使用到 | 2017/11/21 | 优络服务技术 |
| V1.0.6 | 测试环境接口地址变更 | 2017/11/23 | 优络服务技术 |
| V1.0.7 | 商户查询接口变更说明: 1、新增返回审核状态(examineStatus字段): examineStatus原为微信支付权限状态,现变更为审核状态,详见查询接口 2、支付权限状态目前显示到支付中心列表中(payCenters): 新增支付权限状态(tradeAuth)、状态说明(tradeAuthMsg)字段,详见响应参数示例示例 |
2017/12/7 | 优络服务技术 |
| V1.0.8 | 微信公众号配置新增,查询改为支持服务商配置, 新增接口参数服务商编号(providerNo) |
2017/12/26 | 优络服务技术 |
| V1.0.9 | 更改进件模式,如果服务商结算为“结算至服务商”模式,进件时结算信息(balanceAccount)与支付信息(payCenters)可不传 商户资料上传接口将无法使用,也就是不用上传商户资料 |
2018/1/3 | 优络服务技术 |
使用HTTPS作为通讯方式,报文格式为JSON。
交易信息存放在http的请求体(requestbody(请求体)或responsebody(响应体)中)。
HTTPS头部(header)中Content-Type属性需设置为application/json;charset=utf-8
Content-Type:applicatin/json;charset=utf-8
HTTPS头部中accept-type属性需设置为utf-8
加密:
进件接口与第三方机构系统进行对接时,会分配第三方机构签名key
请求报文,是优络作为服务端,接受各合作机构的交易请求。
请求报文:
{"businessContext": {*****},"signKey":"针对businessContext域所有内容进行签名("*****"字体部分)"}
响应报文
{"businessContext": {*****},"signKey":"针对businessContext域所有内容进行签名("*****"字体部分)"}
本系统报文接口数据使用的是UTF-8编码。
通讯使用HTTPS进行通讯,交易内容使用数字证书进行签名。
签名算法:MD5
通讯的双方都需要对各自发送的内容进行签名,并对接收到的数据进行验签具体签名字段说明
trade.weixin.jspay--微信公众号支付
trade.weixin.native--微信扫码支付
trade.weixin.wappay--微信WAP支付
trade.weixin.apppay--微信APP支付
trade.weixin.h5pay--微信H5支付
trade.weixin.micropay--微信刷卡支付
trade.alipay.native--支付宝扫码支付
trade.alipay.jspay--支付宝公众号支付
trade.alipay.micropay–-支付宝小额支付
trade.qqpay.micropay--QQ钱包小额支付
trade.qqpay.native--QQ钱包扫码支付
trade.qqpay.jspay--QQ钱包公众号支付
trade.qqpay.wappay--QQ钱包WAP支付
trade.qqpay.apppay--QQ钱包APP支付
trade.jdpay.native--京东线下扫码支付
trade.jdpay.onlinepay--京东线上扫码支付
trade.jdpay.h5pay--京东线上H5支付
trade.baidu.native--百度扫码支付
| 参数 | API 参数名 | 详细说明 |
| 服务商号 | providerId | 服务商申请优络服务后,由服务平台分配的服务商号 |
| API 密钥 | signKey | 签名的密钥,不会在网络中传播 |
注意:此账户为测试环境服务商账户,接口需调用测试环境接口地址!
| 参数 | API 参数名 | 详细说明 |
| 服务商号 | 26195436 | 服务商申请优络服务后,由服务平台分配的服务商号 |
| API 密钥 | e0553ddc84c25e9e37befed9872f687c | 签名的密钥,不会在网络中传播。 |
测试环境地址:http://cloud.newplat-test.test.szulodev.com/incoming/merchant/add
生产环境地址:https://api.ulopay.com/incoming/merchant/add
特别提醒:服务商测试进件时,请调用测试环境的地址,调试通过,没有问题后再使用正式服务商号和API密钥调生产环境地址
此接口主要用于批量导入商户信息。 需要调用查询接口查询商户审核状态相关。
{"businessContext":{"patchNo":"1499934257416","providerId":"26101158","contents":[{"outerMchNo":"00200","baseInfo":{"mchName":"xxx","mchShortName":"xxx","categoryType":"121","parentMch":null,"parentMchName":null,"creator":null,"goodsName":null,"province":"210000","city":"210200","country":"210201","address":"xxx","customerPhone":"123456789","orgWebsite":"www.xxx.com","linkman":"xxxx","phone":"001001001","email":"xxxx@xxx.com","operator":"xxx","mchRole":"1","operatorIdno":"3333222111112","linenceNo":"888777666","certifcateType":"NATIONAL_LEGAL","contractsType":"LEGAL_PERSON","remark":"xxx"},"balanceAccount":{"type":"0","name":"haha","acntIdentity":"13112719911011003X","bankCode":"0001","bankName":"人民银行","bankCardNo":"00010010001","province":"210000","city":"210200","subBranchName":"支行名称","cardType":1},"payCenters":[{"transId":"trade.alipay.native","settleRate":1,"used":"0","limitSingle":10,"limitDay":100,"limitSingleMin":1,"providerNo":"213123"}]}]},"signKey":"e67cd1a5864b6a5cf0928e24b09aeb1c"}
| 参数说明 | 字段ID | 字段名称 | 类型 | 示例值 | 可空 | 备注 |
| 最外层 | businessContext | 业务数据 | - | - | 否 | - |
| signKey | 签名值 | - | - | 否 | - |
| 参数说明 | 字段ID | 字段名称 | 类型 | 示例值 | 可空 | 备注 |
| businessContext | patchNo | 批次号 | String(128) | 1499934257416 | 否 | 查询时可使用该批次号 |
| providerId | 服务商号 | String | 26101158 | 否 | 由优络平台分配 | |
| contents | 商户列表 | Array | - | 否 | 见下解析 |
| 参数说明 | 字段ID | 字段名称 | 类型 | 示例值 | 可空 | 备注 |
| contents | outerMchNo | 外部商户编号 | String(128) | 00200 | 否 | 服务商系统内的商户号 |
| baseInfo | 商户基本信息 | JSON | - | 否 | 见下解析 | |
| balanceAccount | 商户结算信息 | JSON | - | - | 见下解析 注:如果该服务商为“结算至服务商”模式,结算信息可不传,取服务商结算信息 |
|
| payCenters | 商户支付中心 | Array | - | - | 见下解析 注:如果该服务商为“结算至服务商”模式,支付信息可不传,取服务支付信息 |
| 参数说明 | 字段ID | 字段名称 | 类型 | 示例值 | 可空 | 备注 |
| baseInfo | mchName | 商户名称 | String(128) | YY商户 | 否 | - |
| mchShortName | 商户简称 | String(20) | YY | 否 | 商户简称不得超过20位字符,即20个汉字 | |
| categoryType | 类目 | String (3) | 请参照类目表格式填写 | 否 | 例如:132 | |
| parentMch | 父商户编号 | String(13) | 15121823 | - | ULO平台内部编号 | |
| parentMchName | 父商户名称 | String(128) | AA商户 | - | - | |
| creator | 拓展人员编号 | String(32) | - | - | ULO平台内部业务员编号 | |
| goodsName | 支付显示时的名称 | String(32) | 支付商品 | - | - | |
| province | 省份代码 | String(6) | 省份区码表 | 否 | - | |
| city | 城市代码 | String(6) | 同上 | 否 | - | |
| country | 区县码 | String(6) | 同上 | 否 | - | |
| address | 详细地址 | String(512) | - | 否 | - | |
| customerPhone | 客服电话 | String(32) | - | 否 | - | |
| orgWebsite | 网站 | String(512) | - | - | - | |
| linkman | 联系人 | String(32) | - | 否 | - | |
| phone | 联系电话 | String(32) | - | 否 | - | |
| 联系邮箱 | String(64) | - | 否 | - | ||
| operator | 负责人姓名 | String(64) | - | 否 | - | |
| mchRole | 商户角色 | Int(4) | 0 | 否 | 0 线上商户 1 线下商户 |
|
| operatorIdno | 负责人身份证号码 | String(64) | - | 否 | - | |
| linenceNo | 商户证件编号 | String(50) | - | 否 | (企业或者个体工商户提供营业执照,事业单位提供事证号) | |
| certifcateType | 商户证件类型 | String(32) | NATIONAL_LEGAL | 否 | NATIONAL_LEGAL:营业执照 NATIONAL_LEGAL_MERGE:营业执照(多证合一) INST_RGST_CTF:事业单位法人证书 |
|
| contractsType | 联系人类型 | String(32) | LEGAL_PERSON | 否 | LEGAL_PERSON 法人 CONTROLLER 实际控制人 AGENT 代理人 OTHER 其他 |
|
| remark | 备注 | String(2000) | - | - | - |
| 参数说明 | 字段ID | 字段名称 | 类型 | 示例值 | 可空 | 备注 |
| 对应上文中的balanceAccount | type | 类型 | String(6) | - | 否 | 0 个人 1 企业 |
| name | 账户名 | String(128) | - | 否 | 账户名 | |
| acntIdentity | 证件号码 | String(18) | - | - | - | |
| bankCode | 银行代号 | String(32) | 银行代号表 | 否 | - | |
| bankName | 银行名称 | String(64) | - | - | - | |
| bankCardNo | 银行卡号 | String(32) | - | 否 | - | |
| province | 省编码 | String(6) | 省份区码表 | - | - | |
| city | 市编码 | String(6) | - | - | - | |
| subBranchName | 开户支行名称 | String(32) | 例如:中信银行杭州经济技术开发区支行 | 否 | 必须填入完整的开户支付名称 | |
| cardType | 行内账户 | Int(6) | - | 否 | 1 行内 0 行外 |
| 参数说明 | 字段ID | 字段名称 | 类型 | 示例值 | 可空 | 备注 |
| 对应上文中的payCenters | transId | 支付类型 | String(32) | trade.weixin.native | 否 | 字典示例值 |
| used | 是否启用 | Int(4) | 1 | 否 | 0 禁用 1 启用 |
|
| settleRate | 结算费率 | Numberic(10,2) | 2 | 否 | 2 表示千分之二 | |
| limitSingle | 单笔限额 | Int(11) | - | - | - | |
| limitDay | 单日限额 | Int(11) | - | - | - | |
| limitSingleMin | 单笔最小限额 | Int(11) | - | - | - | |
| thirdAppid | 第三方APPID | String(64) | - | - | 使用微信原生公众号支付商户需传第三方APPID | |
| providerNo | 渠道商编号 | String(32) | - | - | 银行为服务商申请的渠道标识 |
{"businessContext":{"resultCode":"200","resultMsg":"成功","patchNo":"1499939738992","providerId":"26101158","contents":[{"resultCode":"200","resultMsg":"成功","outerMchNo":"00204","platMchNo":"26104576"}]},"signKey":"446fd1a662303c2f33cf8381ff85ced2"}
| 参数说明 | 字段ID | 字段名称 | 类型 | 示例值 | 可空 | 备注 |
| 最外层 | businessContext | 业务数据 | Json | - | - | - |
| signKey | 签名值 | String | - | - | - |
| 参数说明 | 字段ID | 字段名称 | 类型 | 示例值 | 可空 | 备注 |
| businessContext | resultCode | 业务返回代码 | String | 200 | - | 200 表示成功 |
| resultMsg | 业务返回消息 | String | 成功 | - | - | |
| patchNo | 批次号 | String(128) | 1499939738992 | - | - | |
| providerId | 服务商编号 | String | 26101158 | - | - | |
| contents | 详细内容 | Array | - | - | 见下解析 |
| 参数说明 | 字段ID | 字段名称 | 类型 | 示例值 | 可空 | 备注 |
| contents | resultCode | 业务返回代码 | String | 200 | - | 200 表示成功 |
| resultMsg | 业务返回消息 | String | 成功 | - | - | |
| outerMchNo | 外部商户号 | String | 00204 | - | 服务商系统内的商户号 | |
| platMchNo | 平台商户号 | String | - | - | 优络给商户分配的商户编号 |
测试环境地址:http://cloud.newplat-test.test.szulodev.com/incoming/merchant/modify
生产环境地址:https://api.ulopay.com/incoming/merchant/modify
特别提醒:服务商测试进件时,请调用测试环境的地址,调试通过,没有问题后再使用正式服务商号和API密钥调生产环境地址
该接口主要用于修改商户信息
请求和响应的参数,与商户添加接口相同。
测试环境地址:http://cloud.newplat-test.test.szulodev.com/incoming/merchant/query
生产环境地址:https://api.ulopay.com/incoming/merchant/query
特别提醒:服务商测试进件时,请调用测试环境的地址,调试通过,没有问题后再使用正式服务商号和API密钥调生产环境地址
该接口主要用于查询进件的商户的情况
{"businessContext":{"patchNo":"1499996103397","providerId":"26101158","mchNos":["00205"]},"signKey":"0260d776c4f57810cd574c40fc16cf73"}
| 参数说明 | 字段ID | 字段名称 | 类型 | 示例值 | 可空 | 备注 |
| 最外层 | businessContext | 业务数据 | Json | - | - | - |
| signKey | 签名值 | String | - | - | - |
| 参数说明 | 字段ID | 字段名称 | 类型 | 示例值 | 可空 | 备注 |
| businessContext | providerId | 服务商编号 | String | 26101158 | 否 | 服务商编号 |
| patchNo | 添加时的批次号 | String(128) | 1499996103397 | 二选一 | 当mchNos存在时,patchNo 失效 | |
| mchNos | 外部商户号列表 | Array | ["00205"] |
{"businessContext":{"patchNo":"1499997929272","providerId":"26101158","contents":[{"outerMchNo":"00205","baseInfo":{"mchName":"娃哈哈集团400204","mchShortName":"娃哈哈400205","categoryType":"121","parentMch":null,"parentMchName":null,"creator":null,"goodsName":null,"province":"210000","city":"210200","country":"210201","address":"地址","customerPhone":"999999","orgWebsite":" www.wahaha.com","linkman":"火枪","phone":"001001001","email":"xxxx@xxx.com","operator":"呜呜","mchRole":"1","operatorIdno":"3333222111112","linenceNo":"888777666","certifcateType":"NATIONAL_LEGAL","contractsType":"LEGAL_PERSON","remark":"备注"},"balanceAccount":{"type":"0","name":"haha","acntIdentity":"13112719911011003X","bankCode":"0001","bankName":"人民银行","bankCardNo":"00010010001","province":"210000","city":"210200","subBranchName":"支行名称","cardType":1},"payCenters":[{"transId":"trade.weixin.native","used":0,"settleRate":1,"limitSingle":10,"limitDay":100,"limitSingleMin":1,"tradeAuth":1,"tradeAuthMsg":"有支付权限"},{"transId":"trade.weixin.jspay","used":1,"settleRate":1,"limitSingle":10,"limitDay":100,"limitSingleMin":1,"tradeAuth":0,"tradeAuthMsg":"无支付权限"}]}]},"signKey":"7768016c19d9eacde0cfdb447f6e5340"}
| 参数说明 | 字段ID | 字段名称 | 类型 | 示例值 | 可空 | 备注 |
| 最外层 | patchNo | 添加时的批次号 | String | - | - | - |
| providerId | 服务商编号 | String | - | - | - | |
| contents | 查询的商户列表 | Array | - | - | - |
| 参数说明 | 字段ID | 字段名称 | 类型 | 示例值 | 可空 | 备注 |
| contents | platMchNo | 平台商户号 | String | - | - | 优络给商户分配的商户编号 |
| examineStatus | 审核状态 | Int | - | - | 0-待审核 1-审核通过 2-审核未通过 3-冻结 4-接口冻结 |
|
| examineMsg | 审核备注 | String | - | - | - | |
| outerMchNo | 第三方商户号 | String | - | - | 服务商系统内的商户号 | |
| baseInfo | 商户基本信息 | Json | - | - | - | |
| balanceAccount | 结算信息 | Json | - | - | - | |
| payCenters | 支付中心列表 | Array | - | - | - |
测试环境地址:http://cloud.newplat-test.test.szulodev.com/incoming/officialAccount/search
生产环境地址:https://api.ulopay.com/incoming/officialAccount/search
特别提醒:服务商测试进件时,请调用测试环境的地址,调试通过,没有问题后再使用正式服务商号和API密钥调生产环境地址
该接口主要用于查询微信支付公众号配置信息
{"businessContext": {"providerNo": "26199724","merchantNo":"26104515"},"signKey": "871b3059d124146744c2c8f59e830113"}
| 参数说明 | 字段ID | 字段名称 | 类型 | 示例值 | 可空 | 备注 |
| 最外层 | businessContext | 业务数据 | Json | - | - | - |
| signKey | 签名值 | String | - | - | - |
| 参数说明 | 字段ID | 字段名称 | 类型 | 示例值 | 可空 | 备注 |
| businessContext | providerNo | 服务商编号 | String(15) | 26104575 | 否 | - |
| merchantNo | 商户编号 | String(15) | 26104515 | 否 | - |
{"businessContext": {"resultCode": "200","resultMsg": "成功","contents": [{"subscribeAppid": "wx8f6336b2e083a63b","ally": "33115155","jsapiPathList": ["http: //api.test.szulodev.com/pay/","http: //api.test.szulodev.com/pay/add/","http: //api.test.szulodev.com/pay/get/","http: //api.test.szulodev.com/pay/jspay/","http: //api.test.szulodev.com/pay/update/"],"subAppidList": [{"subAppid": "wx662cf4a697ee2bc8"},{"subAppid": "wx8f6336b2e083a63b"}]}]},"signKey": "dc3b3d61d521d7c67cefa2735f7df574"}
| 参数说明 | 字段ID | 字段名称 | 类型 | 示例值 | 可空 | 备注 |
| 最外层 | resultCode | 响应代码 | String | - | - | - |
| resultMsg | 响应消息 | String | - | - | - | |
| contents | 查询的公众号信息 | Array | - | - | - |
| 参数说明 | 字段ID | 字段名称 | 类型 | 示例值 | 可空 | 备注 |
| contents | subscribeAppid | 推荐关注APPID | String | - | - | - |
| ally | 第三方商户号 | String | - | - | - | |
| jsapiPathList | 授权目录列表 | String | - | - | - | |
| subAppidList | 关注APPID | String | - | - | - |
测试环境地址:http://cloud.newplat-test.test.szulodev.com/incoming/officialAccount/config
生产环境地址:https://api.ulopay.com/incoming/officialAccount/config
特别提醒:服务商测试进件时,请调用测试环境的地址,调试通过,没有问题后再使用正式服务商号和API密钥调生产环境地址
该接口主要用于添加微信支付公众号配置信息
{"businessContext": {"jsapiPath": "http: //api.test.szulodev.com/pay/down/","subAppid": "1001012","subscribeAppid": "10012015","providerNo": "26199724","merchantNo": "26101190"},"signKey": "008af7da54fe910e332d81327fc519f9"}
| 参数说明 | 字段ID | 字段名称 | 类型 | 示例值 | 可空 | 备注 |
| 最外层 | businessContext | 业务数据 | Json | - | - | - |
| signKey | 签名值 | String | - | - | - |
| 参数说明 | 字段ID | 字段名称 | 类型 | 示例值 | 可空 | 备注 |
| businessContext | providerNo | 服务商编号 | String | 26190948 | 否 | 平台服务商编号 |
| merchantNo | 商户编号 | String | 351067200 | 否 | 服务平台商户编号 | |
| jsapiPath | 授权目录 | String | - | 配置授权目录时,jsapiPath参数为必传, 关联APPID,推荐关注APPID不传 如果配置推荐关注APPID(subscribeAppid), 则关联APPID(subAppid)不能为空, 如果没有subAppid,请传入“NULL”字符串 |
- | |
| subAppid | 关联APPID | String | - | - | ||
| subscribeAppid | 推荐关注APPID | String | - | - |
{"businessContext": {"resultCode": "200","resultMsg": "成功","contents":{"resultCode": "200","resultMsg": "成功",}},"signKey": "xxx"}
| 参数说明 | 字段ID | 字段名称 | 类型 | 示例值 | 可空 | 备注 |
| 最外层 | businessContext | 业务数据 | Json | - | - | - |
| signKey | 签名值 | String | - | - | - |
| 参数说明 | 字段ID | 字段名称 | 类型 | 示例值 | 可空 | 备注 |
| businessContext | resultCode | 响应代码 | String | - | - | - |
| resultMsg | 响应消息 | String | - | - | - | |
| contents | 业务数据 | String | - | - | - |
| 参数说明 | 字段ID | 字段名称 | 类型 | 示例值 | 可空 | 备注 |
| contents | resultCode | 响应代码 | String | - | - | - |
| resultMsg | 响应消息 | String | - | - | - |
测试环境地址:http://cloud.newplat-test.test.szulodev.com/incoming/merchant/uploadfile
生产环境地址:http://api.ulopay.com/incoming/merchant/uploadfile
特别提醒:服务商测试进件时,请调用测试环境的地址,调试通过,没有问题后再使用正式服务商号和API密钥调生产环境地址
该接口用于上传图片,采用 multipart form 形式上传, 用于上传商户审核所需图片。
注意:图片大小不能超过400kb,超过的请处理一下再进行上传
商户资料上传Demo:点我下载(Java开发语言)(此demo比较简单,仅供商户参考)
| 参数说明 | 字段ID | 字段名称 | 类型 | 示例值 | 可空 | 备注 |
| Multiple Part结构 | linenceImg | 营业执照图片 | File | - | - | - |
| orgAccountImg | 结算账户图片 | File | - | - | - | |
| indentityImg | 身份证正面照 | File | - | - | - | |
| indentityBackImg | 身份证反面照 | File | - | - | - | |
| bankCardImg | 银行卡照 | File | - | - | - | |
| peopleIdentityImg | 结算人手持证件照 | File | - | - | - | |
| protocolPhoto | 商户协议 | File | - | - | - | |
| requisition | 申请表 | File | - | - | - | |
| taxregCert | 税务登记证 | File | - | - | - | |
| mchPromise | 商户承诺函 | File | - | - | - | |
| doorAccord | 门头照 | File | - | - | - | |
| authorizeCert | 授权书 | File | - | - | - | |
| sotckMerSplemt | 存量商户补充协议 | File | - | - | - | |
| content | 携带的内容 | - | - | - | - |
| 参数说明 | 字段ID | 字段名称 | 类型 | 示例值 | 可空 | 备注 |
| content | businessContext | 业务数据 | String | - | 否 | - |
| signKey | 签名值 | String | - | 否 | - | |
| businessContext | patchNo | 批次号 | String | - | 否 | - |
| providerId | 服务商编号 | String | - | 否 | - | |
| outerMchNo | 外部商户号 | String | - | 否 | 服务商系统内的商户号 | |
| - | linenceImg | 营业执照图片 | String | 对应文件MD5值 | 否 | - |
| - | orgAccountImg | 结算账户图片 | String | 同上 | - | - |
| - | indentityImg | 身份证正面照 | String | 同上 | 否 | - |
| - | indentityBackImg | 身份证反面照 | String | 同上 | 否 | - |
| - | bankCardImg | 银行卡照 | String | 同上 | - | - |
| - | peopleIdentityImg | 结算人手持证件照 | String | 同上 | - | - |
| - | protocolPhoto | 商户协议 | String | 同上 | - | - |
| - | requisition | 申请表 | String | 同上 | - | - |
| - | taxregCert | 税务登记证 | String | 同上 | - | - |
| - | mchPromise | 商户承诺函 | String | 同上 | - | - |
| - | doorAccord | 门头照 | String | 同上 | - | - |
| - | authorizeCert | 授权书 | String | 同上 | - | - |
| - | sotckMerSplemt | 存量商户补充协议 | String | 同上 | - | - |
| 参数说明 | 字段ID | 字段名称 | 类型 | 示例值 | 可空 | 备注 |
| 最外层 | businessContext | 业务数据 | Json | - | - | - |
| signKey | 签名值 | String | - | - | - |
| 参数说明 | 字段ID | 字段名称 | 类型 | 示例值 | 可空 | 备注 |
| businessContext | patchNo | 批次号 | String | - | - | - |
| providerId | 服务商编号 | String | - | - | - | |
| outerMchNo | 外部商户号 | String | - | - | - | |
| - | linenceImg | 营业执照图片 | ImageUploadResp | - | - | - |
| - | orgAccountImg | 结算账户图片 | ImageUploadResp | - | - | - |
| - | indentityImg | 身份证正面照 | ImageUploadResp | - | - | - |
| - | indentityBackImg | 身份证反面照 | ImageUploadResp | - | - | - |
| - | bankCardImg | 银行卡照 | ImageUploadResp | - | - | - |
| - | peopleIdentityImg | 结算人手持证件照 | ImageUploadResp | - | - | - |
| - | protocolPhoto | 商户协议 | ImageUploadResp | - | - | - |
| - | requisition | 申请表 | ImageUploadResp | - | - | - |
| - | taxregCert | 税务登记证 | ImageUploadResp | - | - | - |
| - | mchPromise | 商户承诺函 | ImageUploadResp | - | - | - |
| - | doorAccord | 门头照 | ImageUploadResp | - | - | - |
| - | authorizeCert | 授权书 | ImageUploadResp | - | - | - |
| - | sotckMerSplemt | 存量商户补充协议 | ImageUploadResp | - | - | - |