交易请求报文

JSON:

  1. {
  2. "request_type": "merchant_indvregister_request",
  3. "isspid": "39493002",
  4. "pos_seq": "2022112500001",,
  5. "system_id": "8888",
  6. "merchant_indvregister_request": {
  7. "merchant_id": "1000102",
  8. "identity_type": "1",
  9. "merchant_name": "xx公司",
  10. "legal_name": "xx",
  11. "identity_no": "xxx",
  12. "identity_begin_date": "19630607",
  13. "identity_end_date": "20220102",
  14. "identity_validity_type": "1",
  15. "contact_phone": "18506050000",
  16. "cert_photo_a": "2022071913584699758",
  17. "cert_photo_b": "2022071913584699758"
  18. },
  19. "sign": "712036C2324D76F2934C44C95A80CEBA"
  20. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <request_type>merchant_indvregister_request</request_type>
  4. <isspid>39493002</isspid>
  5. <pos_seq>1511300000001</pos_seq>
  6. <system_id>8888</system_id>
  7. <merchant_indvregister_request>
  8. <merchant_id>1000102</merchant_id>
  9. <identity_type>1</identity_type>
  10. <merchant_name>xx公司</merchant_name>
  11. <legal_name>xx</legal_name>
  12. <identity_no>xx</identity_no>
  13. <identity_begin_date>19630607</identity_begin_date>
  14. <identity_end_date>20220102</identity_end_date>
  15. <identity_validity_type>1</identity_validity_type>
  16. <contact_phone>18506050000</contact_phone>
  17. <cert_photo_a>2022071913584699758</cert_photo_a>
  18. <cert_photo_b>2022071913584699758</cert_photo_b>
  19. </merchant_indvregister_request>
  20. </business_trans>

交易请求报文说明

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节
可选
request_type请求类型String(32)固定值:merchant_indvregister_request必填
system_id系统平台号String(4)由翼码提供必填
isspid商户号String(8)翼码商户号,由翼码提供必填
pos_seq请求流水号String(32)同一个翼码商户号下唯一,不可重复使用,且大于12位必填
merchant_indvregister_request
->merchant_id
分账商户idString(32)分账商户id必填
merchant_indvregister_request
->merchant_name
用户名称String(50)用户名称必填
merchant_indvregister_request
->identity_type
法人证件类型String(2)0:护照(大陆)
1:身份证
11:港澳台同胞通行证
12:外国人居留证
13:港澳居民证
14:台湾居民证
必填
merchant_indvregister_request
->legal_name
法人姓名String(15)法人姓名必填
merchant_indvregister_request
->identity_no
证件号码String(18)证件号码必填
merchant_indvregister_request
->identity_begin_date
法人证件有效期开始时间String(8)格式:yyyyMMdd必填
merchant_indvregister_request
->identity_end_date
法人证件有效期结束时间String(8)格式:yyyyMMdd;非长期有效时必填可选
merchant_indvregister_request
->identity_validity_type
法人证件有效期类型String(1)1:长期,0:非长期,默认0必填
merchant_indvregister_request
->contact_phone
联系人电话String(20)联系人电话必填
merchant_indvregister_request
->cert_photo_a
证件照正面,参考《图片上传接口》String图片id必填
merchant_indvregister_request
->cert_photo_b
证件照反面,证件类型为身份证时必填,参考《图片上传接口》String图片id可选

交易返回报文

JSON:

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

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