交易请求报文

JSON:

  1. {
  2. "request_type": "merchant_entmodify_request",
  3. "isspid": "00058301",
  4. "pos_seq": "2022112500001",
  5. "system_id": "8888",
  6. "merchant_entmodify_request": {
  7. "merchant_id": "100010511",
  8. "license_begin_date": "20170718",
  9. "license_end_date": "20170718",
  10. "license_validity_type": "1",
  11. "license_address": "xx",
  12. "legal_name": "xx",
  13. "identity_no": "35010519630607xxxx",
  14. "identity_begin_date": "19630607",
  15. "identity_end_date": "19630607",
  16. "identity_validity_type": 1,
  17. "contact_name": "xx",
  18. "contact_email": "18506050000@gmail.com",
  19. "license_photo": "11",
  20. "cert_photo_a": "11",
  21. "cert_photo_b": "11",
  22. "license_province_code": "420000",
  23. "license_city_code": "420000",
  24. "license_area_code": "420000",
  25. "contact_phone": "18506050000"
  26. },
  27. "sign": "712036C2324D76F2934C44C95A80CEBA"
  28. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <request_type>merchant_entmodify_request</request_type>
  4. <isspid>00058301</isspid>
  5. <pos_seq>2022112500001</pos_seq>
  6. <system_id>8888</system_id>
  7. <merchant_entmodify_request>
  8. <merchant_id>100010511</merchant_id>
  9. <license_begin_date>20170718</license_begin_date>
  10. <license_end_date>20170718</license_end_date>
  11. <license_validity_type>1</license_validity_type>
  12. <license_address>xx</license_address>
  13. <legal_name>xx</legal_name>
  14. <identity_no>35010519630607xxxx</identity_no>
  15. <identity_begin_date>19630607</identity_begin_date>
  16. <identity_end_date>19630607</identity_end_date>
  17. <identity_validity_type>1</identity_validity_type>
  18. <contact_name>xx</contact_name>
  19. <contact_email>18506050000@gmail.com</contact_email>
  20. <license_photo>11</license_photo>
  21. <cert_photo_a>11</cert_photo_a>
  22. <cert_photo_b>11</cert_photo_b>
  23. <license_province_code>420000</license_province_code>
  24. <license_city_code>420000</license_city_code>
  25. <license_area_code>420000</license_area_code>
  26. <contact_phone>18506050000</contact_phone>
  27. </merchant_entmodify_request>
  28. </business_trans>

交易请求报文说明

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

交易返回报文

JSON:

  1. {
  2. "response_type": "merchant_entmodify_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_entmodify_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_entmodify_response必填
isspid商户号String(8)翼码商户号,由翼码提供必填
pos_seq请求流水号String(32)请求流水号可选
trans_time交易时间String(14)交易时间,格式:yyyyMMddHHmmss必填
result
->id
响应码String(4)翼码平台返回的处理结果,0000-成功,其它失败,错误信息说明见“响应码解释”字段必填
result
->comment
响应码解释String(64)响应码对应中文注解,用于显示提示必填

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