交易请求报文
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": "测试商户","incoming_status": 2,"merchant_type": "1","settlement_way": 1,"withdraw_way": 2,"withdraw_type": 1,"nature_day_num": 1,"settle_cycle": "D1,D0","settle_fee_flag": 1,"settle_fee_account": "666000000000000001","settle_fee_acct_type": "01","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_name": "测试商户","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><incoming_status>2</incoming_status><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><settle_cycle>D1,D0</settle_cycle><settle_fee_flag>1</settle_fee_flag><settle_fee_account>666000000000000001</settle_fee_account><settle_fee_acct_type>01</settle_fee_acct_type><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_name>测试商户</card_name><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 | 商户状态 | Number | 0:待进件 -1:进件失败(开户失败) 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]; | 可选 |
| settle_cycle | 到账时间 | String | T1:下一个工作日到银行账户 D1:下一个自然日到银行账户 D0:当日到银行账户 多个时使用半角逗号分隔。 | 可选 |
| settle_fee_flag | D1/D0手续费扣收方式 | Number | 1:外扣(从指定的账户中扣除手续费) 2:内扣(直接从提现/结算的收款账户中扣除) | 可选 |
| settle_fee_account | 手续费外扣账户 | String | 可选 | |
| settle_fee_acct_type | 手续费外扣账户类型 | String | 01:基本户 05:充值户 | 可选 |
| 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_name | 卡户名 | String(16) | 银行卡户名 | 可选 |
| card_no | 银行卡号 | String(20) | 银行卡号 | 可选 |
| parent_bank_name | 结算开户银行名称 | String(32) | 需严格按照银行列表上送, 部分银行支持多种上送方式,选其一上送即可。 注:测试环境建议使用工农中建交。 | 可选 |
| parent_bank_code | 结算开户银行号 | String(20) | 结算开户银行号,编码参考《银行编码》 | 可选 |
| province | 开户行所在省 | String(6) | 开户行所在省,开户行所在市必须同时上送,地区编码参考《地区编码》 | 可选 |
| branch_bank_code | 支行联行号 | String(12) | 参考《支行编码》中完整“联行号” | 可选 |
| branch_bank_name | 开户支行联行名称 | String(32) | 参考《支行编码》中完整“联行名称” | 可选 |
| remained_amt | 留存金额 | Number(13) | 小于等于该金额不会结算,单位为分 | 可选 |
| settle_abstract | 结算摘要 | String(60) | 自定义结算打款备注 | 可选 |
| image_list | 图片列表 | String | 图片列表,JSONArray | 可选 |
| result ->id | 响应码 | String(4) | 翼码平台返回的处理结果,0000-成功,其它失败,错误信息说明见“响应码解释”字段 | 必填 |
| result ->comment | 响应码解释 | String(64) | 响应码对应中文注解,用于显示提示 | 必填 |
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!
image_list 图片列表 (JSONArray)
| JSON节点 | 参数名称 | 类型 | 说明 | 是否必填 |
|---|---|---|---|---|
| file_type | 图片类型 | String | 01:负责人或企业法人代表的身份证图片正面 02:负责人或企业法人代表的身份证图片反面 03:营业执照图片 04:组织机构代码证图片 05:开户许可证照片 06:门头照 07:其他图片 08:收银台照片 09:门店内景照片 10: 各大餐饮平台入驻照片 11: 手持身份证照片 12: 租赁协议图片 13:结算卡正面照 14:结算卡反面照 15:法人护照人像面 17:法人港澳台通行证正面 19:法人其它证件照片(如外国人居留证) 21:法人其它证件照片-港澳居民证 23:法人其它证件照片-台湾居民证 24:非同名结算证明材料 | 必填 |
| file_id | 图片id | String | 图片id | 必填 |
| file_url | 图片url | String | 图片url | 必填 |
| file_name | 图片名称 | String | 图片名称 | 必填 |


