交易请求报文
JSON:
{
"request_type": "merchant_query_request",
"isspid": "00058301",
"pos_seq": "2022112500001",
"system_id": "8888",
"merchant_query_request": {
"merchant_id": "1000105"
},
"sign": "712036C2324D76F2934C44C95A80CEBA"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<request_type>merchant_query_request</request_type>
<isspid>00058301</isspid>
<pos_seq>2022112500001</pos_seq>
<system_id>8888</system_id>
<merchant_query_request>
<merchant_id>1000105</merchant_id>
</merchant_query_request>
</business_trans>
交易请求报文说明
节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
---|---|---|---|---|
sign | 报文签名 | String(32) | 请求报文格式为JSON时必填 计算签名方式请看2.1章节 | 可选 |
request_type | 请求类型 | String(32) | 固定值:merchant_query_request | 必填 |
system_id | 系统平台号 | String(4) | 由翼码提供 | 必填 |
isspid | 商户号 | String(8) | 翼码商户号,由翼码提供 | 必填 |
pos_seq | 请求流水号 | String(32) | 同一个翼码商户号下唯一,不可重复使用,且大于12位 | 必填 |
merchant_query_request ->merchant_id | 分账商户id,手机号和分账商户id二选一必填 | String | 分账商户id | 可选 |
merchant_query_request ->phone | 手机号,手机号和分账商户id二选一必填 | String | 手机号 | 可选 |
交易返回报文
JSON:
{
"response_type": "merchant_query_response",
"isspid": "00058999",
"pos_id": "test083001",
"pos_seq": "2022112500001",
"trans_time": "20221219160941",
"city": "350100",
"merchant_id": "1000105"
"merchant_name": "测试商户",
"merchant_type": "1",
"settlement_way": 1,
"withdraw_way": 2,
"withdraw_type": 1,
"nature_day_num": 1,
"license_code": "91350105MAXXXX",
"license_begin_date": "20170718",
"license_end_date": "20170718",
"license_validity_type": "1",
"license_province_code": "350000",
"license_city_code": "350100",
"license_area_code": "350105",
"license_address": "测试地址",
"identity_type": "1",
"legal_name": "XX",
"identity_no": "35010519880101004X",
"identity_begin_date": "19630607",
"identity_end_date": "19630607",
"identity_validity_type": "1",
"contact_name": "XX",
"contact_phone": "18506050000",
"contact_email": "18506050000@qq.com",
"settle_type": "1",
"card_no": "140220140960000000",
"parent_bank_name": "中国工商银行",
"province": "350000",
"card_province_name": "福建省",
"card_city_name": "福州市",
"branch_bank_code": "102391052409",
"branch_bank_name": "中国工商银行股份有限公司福州铜盘支行",
"remained_amt": 100,
"settle_abstract": "业务收款",
"image_list": "[{\"file_id\":\"2022121516440696502\",\"file_name\":\"639ade56e4b0cac33bb6fba1.jpeg\",\"file_url\":\"https://xxx.com/file/merchantImages/14/639ade56e4b0cac33bb6fba1.jpeg\",\"file_type\":\"14\"}]",
"result": {
"id": "0000",
"comment": "操作成功"
},
"sign": "CAC0BA2826E985E7FD58C955975246B1"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<response_type>merchant_query_response</response_type>
<isspid>00058999</isspid>
<pos_id>test083001</pos_id>
<pos_seq>2022112500001</pos_seq>
<trans_time>20221219160941</trans_time>
<city>350100</city>
<merchant_id>1000105</merchant_id>
<merchant_name>测试商户</merchant_name>
<merchant_type>1</merchant_type>
<settlement_way>1</settlement_way>
<withdraw_way>2</withdraw_way>
<withdraw_type>1</withdraw_type>
<nature_day_num>1</nature_day_num>
<license_code>91350105MAXXXX</license_code>
<license_begin_date>20170718</license_begin_date>
<license_end_date>20170718</license_end_date>
<license_validity_type>1</license_validity_type>
<license_province_code>350000</license_province_code>
<license_city_code>350100</license_city_code>
<license_area_code>350105</license_area_code>
<license_address>测试地址</license_address>
<identity_type>1</identity_type>
<legal_name>XX</legal_name>
<identity_no>35010519880101004X</identity_no>
<identity_begin_date>19630607</identity_begin_date>
<identity_end_date>19630607</identity_end_date>
<identity_validity_type>1</identity_validity_type>
<contact_name>XX</contact_name>
<contact_phone>18506050000</contact_phone>
<contact_email>18506050000@qq.com</contact_email>
<settle_type>1</settle_type>
<card_no>140220140960000000</card_no>
<parent_bank_name>中国工商银行</parent_bank_name>
<province>350000</province>
<card_province_name>福建省</card_province_name>
<card_city_name>福州市</card_city_name>
<branch_bank_code>102391052409</branch_bank_code>
<branch_bank_name>中国工商银行股份有限公司福州铜盘支行</branch_bank_name>
<remained_amt>100</remained_amt>
<settle_abstract>业务收款</settle_abstract>
<image_list>[]</image_list>
<result>
<id>0000</id>
<comment>操作成功</comment>
</result>
<sign>CAC0BA2826E985E7FD58C955975246B1</sign>
</business_trans>
交易返回报文说明
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!
节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
---|---|---|---|---|
sign | 报文签名 | String(32) | 返回报文格式为JSON时必填 计算签名方式请看2.1章节 | 可选 |
response_type | 返回类型 | String(32) | 固定值:merchant_query_response | 必填 |
isspid | 商户号 | String(8) | 翼码商户号,由翼码提供 | 必填 |
pos_seq | 请求流水号 | String(32) | 请求流水号 | 可选 |
trans_time | 交易时间 | String(14) | 交易时间,格式:yyyyMMddHHmmss | 必填 |
city | 开户行所在地 市码,地区编码参考《地区编码》 | String(6) | 开户行所在地 市码 | 可选 |
merchant_id | 用户名称 | String | 用户id | 可选 |
merchant_name | 用户名称 | String(50) | 用户名称 | 可选 |
incoming_status | 商户状态 | String(1) | 0:待进件,-1:进件失败(开户失败),2:进件成功(已开户并且业务入驻成功),3:通道开户成功(已开户,但未做业务入驻或业务入驻失败) | 可选 |
base_merchant_short_name | 用户简称 | String | 用户简称 | 可选 |
base_manager_phone | 用户手机号 | String | 用户手机号 | 可选 |
merchant_type | 用户类型 | String(1) | 1:企业商户,2:个体商户, 3:小微商户 | 可选 |
settlement_way | 结算方式 | Number | 0:提现,1:自动结算 | 可选 |
withdraw_way | 提现方式 | Number | 1:手动提现,2:自动提现;仅结算方式为提现时返回 | 可选 |
withdraw_type | 提现类型 | Number | 1:周期提现,2:账期提现;仅提现方式为自动提现时返回 | 可选 |
nature_day_num | 提现间隔时间 | Number | 仅有填写提现类型时返回,到达该时间后系统会进行自动提现,单位为自然日,取值范围[0,120]; | 可选 |
license_code | 营业执照/统一社会信用证 | String(32) | 营业执照/统一社会信用证(三证合一) | 可选 |
license_begin_date | 营业执照有效开始日期 | String(8) | 格式:yyyyMMdd | 可选 |
license_end_date | 营业执照有效结束日期 | String(8) | 格式:yyyyMMdd | 可选 |
license_validity_type | 营业执照永久有效标识 | String(1) | 1:永久,0:非永久,默认0 | 可选 |
license_province_code | 营业执照注册地 省码,地区编码参考《地区编码》 | String(6) | 营业执照注册地 省码 | 可选 |
license_city_code | 营业执照注册地 市码,地区编码参考《地区编码》 | String(6) | 营业执照注册地 市码 | 可选 |
license_area_code | 营业执照注册地 区县码,地区编码参考《地区编码》 | String(6) | 营业执照注册地 区县码 | 可选 |
license_address | 营业执照地址 | String(64) | 营业执照地址 | 可选 |
identity_type | 法人证件类型 | String(1) | 1:身份证(目前只支持身份证) | 可选 |
legal_name | 法人姓名 | String(15) | 法人姓名 | 可选 |
identity_no | 证件号码 | String(18) | 证件号码 | 可选 |
identity_begin_date | 法人证件有效期开始时间 | String(8) | 格式:yyyyMMdd | 可选 |
identity_end_date | 法人证件有效期结束时间 | String(8) | 格式:yyyyMMdd | 可选 |
identity_validity_type | 法人证件有效期类型 | String(1) | 1:长期,0:非长期,默认0 | 可选 |
contact_name | 联系人姓名 | String(15) | 联系人姓名 | 可选 |
contact_phone | 联系人电话 | String(20) | 联系人电话 | 可选 |
contact_email | 联系人邮箱 | String(20) | 联系人邮箱 | 可选 |
settle_type | 结算卡类型 | String(1) | 1:对公,2:对私,3:对私非法人 | 可选 |
card_no | 银行卡号 | String(20) | 银行卡号 | 可选 |
parent_bank_name | 结算开户银行名称 | String(32) | 需严格按照银行列表上送, 部分银行支持多种上送方式,选其一上送即可。 注:测试环境建议使用工农中建交。 | 可选 |
parent_bank_code | 结算开户银行号 | String(20) | 结算开户银行号,编码参考《银行编码》 | 可选 |
province | 开户行所在省 | String(6) | 开户行所在省,开户行所在市必须同时上送,地区编码参考《地区编码》 | 可选 |
branch_bank_code | 支付行号 | String(12) | 12位数字,参考《银行支付编码 2022.10.18版本》 | 可选 |
branch_bank_name | 开户支行名称 | String(32) | 开户支行名称 | 可选 |
->remained_amt | 留存金额 | Number(13) | 小于等于该金额不会结算,单位为分 | 可选 |
settle_abstract | 结算摘要 | String(60) | 自定义结算打款备注 | 可选 |
image_list | 图片列表 | Array | 图片列表 | 可选 |
image_list ->file_type | 图片类型 | String | 01:负责人或企业法人代表的身份证图片正面, 02:负责人或企业法人代表的身份证图片反面, 03:营业执照图片, 04:组织机构代码证图片, 05:开户许可证照片, 06:门头照, 07:其他图片, 08:收银台照片, 09:门店内景照片, 10: 各大餐饮平台入驻照片, 11: 手持身份证照片, 12: 租赁协议图片,13:结算卡正面照 14:结算卡反面照 | 可选 |
image_list ->file_id | 图片id | String | 图片id | 可选 |
image_list ->file_url | 图片url | String | 图片url | 可选 |
image_list ->file_name | 图片名称 | String | 图片名称 | 可选 |
result ->id | 响应码 | String(4) | 翼码平台返回的处理结果,0000-成功,其它失败,错误信息说明见“响应码解释”字段 | 必填 |
result ->comment | 响应码解释 | String(64) | 响应码对应中文注解,用于显示提示 | 必填 |
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!