交易请求报文

JSON:

  1. {
  2. "request_type": "merchant_entregister_request",
  3. "isspid": "00058301",
  4. "pos_seq": "2022112500001",
  5. "system_id": "8888",
  6. "merchant_entregister_request": {
  7. "merchant_id": "1000105",
  8. "merchant_name": "xx公司",
  9. "license_code": "xx",
  10. "license_begin_date": "20170718",
  11. "license_end_date": "20170718",
  12. "license_validity_type": "1",
  13. "license_province_code": "350000",
  14. "license_city_code": "350100",
  15. "license_area_code": "350105",
  16. "license_address": "xx",
  17. "identity_type": "1",
  18. "legal_name": "xx",
  19. "identity_no": "3501051963060xxxxx",
  20. "identity_begin_date": "19630607",
  21. "identity_end_date": "19630607",
  22. "identity_validity_type": "1",
  23. "contact_name": "xx",
  24. "contact_phone": "18506050000",
  25. "contact_email": "18506050000@gmail.com",
  26. "license_photo": "11",
  27. "cert_photo_a": "11",
  28. "cert_photo_b": "11"
  29. },
  30. "sign": "712036C2324D76F2934C44C95A80CEBA"
  31. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <request_type>merchant_entregister_request</request_type>
  4. <isspid>39493002</isspid>
  5. <pos_seq>1511300000001</pos_seq>
  6. <system_id>8888</system_id>
  7. <merchant_entregister_request>
  8. <merchant_id>1000105</merchant_id>
  9. <merchant_name>xx公司</merchant_name>
  10. <license_code>xx</license_code>
  11. <license_begin_date>20170718</license_begin_date>
  12. <license_end_date>20170718</license_end_date>
  13. <license_validity_type>1</license_validity_type>
  14. <license_province_code>350000</license_province_code>
  15. <license_city_code>350100</license_city_code>
  16. <license_area_code>350105</license_area_code>
  17. <license_address>xx</license_address>
  18. <identity_type>1</identity_type>
  19. <legal_name>xx</legal_name>
  20. <identity_no>350105196xxxxxx</identity_no>
  21. <identity_begin_date>19630607</identity_begin_date>
  22. <identity_end_date>19630607</identity_end_date>
  23. <identity_validity_type>1</identity_validity_type>
  24. <contact_name>xx</contact_name>
  25. <contact_phone>18506050000</contact_phone>
  26. <contact_email>18506050000@gmail.com</contact_email>
  27. <license_photo>11</license_photo>
  28. <cert_photo_a>11</cert_photo_a>
  29. <cert_photo_b>11</cert_photo_b>
  30. </merchant_entregister_request>
  31. </business_trans>

交易请求报文说明

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节
可选
request_type请求类型String(32)固定值:merchant_entregister_request必填
system_id系统平台号String(4)由翼码提供必填
isspid商户号String(8)翼码商户号,由翼码提供必填
pos_seq请求流水号String(32)同一个翼码商户号下唯一,不可重复使用,且大于12位必填
merchant_entregister_request
->merchant_id
分账商户idString分账商户id必填
merchant_entregister_request
->merchant_name
商户名称String(50)商户名称必填
merchant_entregister_request
->license_code
营业执照/统一社会信用证String(32)营业执照/统一社会信用证(三证合一)必填
merchant_entregister_request
->license_begin_date
营业执照有效开始日期String(8)格式:yyyyMMdd必填
merchant_entregister_request
->license_end_date
营业执照有效结束日期String(8)格式:yyyyMMdd;非永久有效时必填可选
merchant_entregister_request
->license_validity_type
营业执照永久有效标识String(1)1:永久,0:非永久,默认0必填
merchant_entregister_request
->license_province_code
营业执照注册地 省码,地区编码参考《地区编码》String(6)营业执照注册地 省码必填
merchant_entregister_request
->license_city_code
营业执照注册地 市码,地区编码参考《地区编码》String(6)营业执照注册地 市码必填
merchant_entregister_request
->license_area_code
营业执照注册地 区县码,地区编码参考《地区编码》String(6)营业执照注册地 区县码必填
merchant_entregister_request
->license_address
营业执照地址String(64)营业执照地址必填
merchant_entregister_request
->identity_type
法人证件类型String(2)0:护照(大陆)
1:身份证
11:港澳台同胞通行证
12:外国人居留证
13:港澳居民证
14:台湾居民证
必填
merchant_entregister_request
->identity_validity_type
法人证件有效期类型String(1)1:长期,0:非长期,默认0必填
merchant_entregister_request
->legal_name
法人姓名String(15)法人姓名必填
merchant_entregister_request
->identity_no
证件号码String(18)证件号码必填
merchant_entregister_request
->identity_begin_date
法人证件有效期开始时间String(8)格式:yyyyMMdd必填
merchant_entregister_request
->identity_end_date
法人证件有效期结束时间String(8)格式:yyyyMMdd;非长期有效时必填可选
merchant_entregister_request
->contact_name
联系人姓名String(15)联系人姓名必填
merchant_entregister_request
->contact_phone
联系人电话String(20)联系人电话必填
merchant_entregister_request
->contact_email
联系人邮箱String(20)联系人邮箱可选
merchant_entregister_request
->license_photo
营业执照/统一社会信用证(三证合一),参考《图片上传接口》String(20)图片id必填
merchant_entregister_request
->cert_photo_a
证件照正面,参考《图片上传接口》String图片id必填
merchant_entregister_request
->cert_photo_b
证件照反面,证件类型为身份证时必填,参考《图片上传接口》String图片id可选

交易返回报文

JSON:

  1. {
  2. "response_type": "merchant_entregister_response",
  3. "isspid": "00058301",
  4. "pos_seq": "2022112500001",
  5. "trans_time": "20221207154725",
  6. "result": {
  7. "id": "0000",
  8. "comment": "操作成功"
  9. },
  10. "sign": "03B62B8B16844549FFF01F4659B4AE0A"
  11. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <response_type>merchant_entregister_response</response_type>
  4. <isspid>00058301</isspid>
  5. <pos_seq>2022112500001</pos_seq>
  6. <trans_time>20090405010104</trans_time>
  7. <result>
  8. <id>0000</id>
  9. <comment>成功</comment>
  10. </result>
  11. </business_trans>

交易返回报文说明

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

节点名称中文名称类型说明是否必填
sign报文签名String(32)返回报文格式为JSON时必填
计算签名方式请看2.1章节
可选
response_type返回类型String(32)固定值:merchant_entregister_response必填
isspid商户号String(8)翼码商户号,由翼码提供必填
pos_seq请求流水号String(32)请求流水号可选
trans_time交易时间String(14)交易时间,格式:yyyyMMddHHmmss必填
result
->id
响应码String(4)翼码平台返回的处理结果,0000-成功,其它失败,错误信息说明见“响应码解释”字段必填
result
->comment
响应码解释String(64)响应码对应中文注解,用于显示提示必填

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