交易请求报文

JSON:

  1. {
  2. "request_type": "merchant_query_request",
  3. "isspid": "00058301",
  4. "pos_seq": "2022112500001",
  5. "system_id": "8888",
  6. "merchant_query_request": {
  7. "merchant_id": "1000105"
  8. },
  9. "sign": "712036C2324D76F2934C44C95A80CEBA"
  10. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <request_type>merchant_query_request</request_type>
  4. <isspid>00058301</isspid>
  5. <pos_seq>2022112500001</pos_seq>
  6. <system_id>8888</system_id>
  7. <merchant_query_request>
  8. <merchant_id>1000105</merchant_id>
  9. </merchant_query_request>
  10. </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:

  1. {
  2. "response_type": "merchant_query_response",
  3. "isspid": "00058999",
  4. "pos_id": "test083001",
  5. "pos_seq": "2022112500001",
  6. "trans_time": "20221219160941",
  7. "city": "350100",
  8. "merchant_id": "1000105"
  9. "merchant_name": "测试商户",
  10. "merchant_type": "1",
  11. "settlement_way": 1,
  12. "withdraw_way": 2,
  13. "withdraw_type": 1,
  14. "nature_day_num": 1,
  15. "license_code": "91350105MAXXXX",
  16. "license_begin_date": "20170718",
  17. "license_end_date": "20170718",
  18. "license_validity_type": "1",
  19. "license_province_code": "350000",
  20. "license_city_code": "350100",
  21. "license_area_code": "350105",
  22. "license_address": "测试地址",
  23. "identity_type": "1",
  24. "legal_name": "XX",
  25. "identity_no": "35010519880101004X",
  26. "identity_begin_date": "19630607",
  27. "identity_end_date": "19630607",
  28. "identity_validity_type": "1",
  29. "contact_name": "XX",
  30. "contact_phone": "18506050000",
  31. "contact_email": "18506050000@qq.com",
  32. "settle_type": "1",
  33. "card_no": "140220140960000000",
  34. "parent_bank_name": "中国工商银行",
  35. "province": "350000",
  36. "card_province_name": "福建省",
  37. "card_city_name": "福州市",
  38. "branch_bank_code": "102391052409",
  39. "branch_bank_name": "中国工商银行股份有限公司福州铜盘支行",
  40. "remained_amt": 100,
  41. "settle_abstract": "业务收款",
  42. "image_list": "[{\"file_id\":\"2022121516440696502\",\"file_name\":\"639ade56e4b0cac33bb6fba1.jpeg\",\"file_url\":\"https://xxx.com/file/merchantImages/14/639ade56e4b0cac33bb6fba1.jpeg\",\"file_type\":\"14\"}]",
  43. "result": {
  44. "id": "0000",
  45. "comment": "操作成功"
  46. },
  47. "sign": "CAC0BA2826E985E7FD58C955975246B1"
  48. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <response_type>merchant_query_response</response_type>
  4. <isspid>00058999</isspid>
  5. <pos_id>test083001</pos_id>
  6. <pos_seq>2022112500001</pos_seq>
  7. <trans_time>20221219160941</trans_time>
  8. <city>350100</city>
  9. <merchant_id>1000105</merchant_id>
  10. <merchant_name>测试商户</merchant_name>
  11. <merchant_type>1</merchant_type>
  12. <settlement_way>1</settlement_way>
  13. <withdraw_way>2</withdraw_way>
  14. <withdraw_type>1</withdraw_type>
  15. <nature_day_num>1</nature_day_num>
  16. <license_code>91350105MAXXXX</license_code>
  17. <license_begin_date>20170718</license_begin_date>
  18. <license_end_date>20170718</license_end_date>
  19. <license_validity_type>1</license_validity_type>
  20. <license_province_code>350000</license_province_code>
  21. <license_city_code>350100</license_city_code>
  22. <license_area_code>350105</license_area_code>
  23. <license_address>测试地址</license_address>
  24. <identity_type>1</identity_type>
  25. <legal_name>XX</legal_name>
  26. <identity_no>35010519880101004X</identity_no>
  27. <identity_begin_date>19630607</identity_begin_date>
  28. <identity_end_date>19630607</identity_end_date>
  29. <identity_validity_type>1</identity_validity_type>
  30. <contact_name>XX</contact_name>
  31. <contact_phone>18506050000</contact_phone>
  32. <contact_email>18506050000@qq.com</contact_email>
  33. <settle_type>1</settle_type>
  34. <card_no>140220140960000000</card_no>
  35. <parent_bank_name>中国工商银行</parent_bank_name>
  36. <province>350000</province>
  37. <card_province_name>福建省</card_province_name>
  38. <card_city_name>福州市</card_city_name>
  39. <branch_bank_code>102391052409</branch_bank_code>
  40. <branch_bank_name>中国工商银行股份有限公司福州铜盘支行</branch_bank_name>
  41. <remained_amt>100</remained_amt>
  42. <settle_abstract>业务收款</settle_abstract>
  43. <image_list>[]</image_list>
  44. <result>
  45. <id>0000</id>
  46. <comment>操作成功</comment>
  47. </result>
  48. <sign>CAC0BA2826E985E7FD58C955975246B1</sign>
  49. </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结算方式Number0:提现,1:自动结算可选
withdraw_way提现方式Number1:手动提现,2:自动提现;仅结算方式为提现时返回可选
withdraw_type提现类型Number1:周期提现,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
图片类型String01:负责人或企业法人代表的身份证图片正面, 02:负责人或企业法人代表的身份证图片反面, 03:营业执照图片, 04:组织机构代码证图片, 05:开户许可证照片, 06:门头照, 07:其他图片, 08:收银台照片, 09:门店内景照片, 10: 各大餐饮平台入驻照片, 11: 手持身份证照片, 12: 租赁协议图片,13:结算卡正面照 14:结算卡反面照可选
image_list
->file_id
图片idString图片id可选
image_list
->file_url
图片urlString图片url可选
image_list
->file_name
图片名称String图片名称可选
result
->id
响应码String(4)翼码平台返回的处理结果,0000-成功,其它失败,错误信息说明见“响应码解释”字段必填
result
->comment
响应码解释String(64)响应码对应中文注解,用于显示提示必填

标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!