交易请求报文

JSON:

  1. {
  2. "request_type": "merchant_create_request",
  3. "isspid": "00058301",
  4. "pos_seq": "2022112500001",
  5. "system_id": "8888",
  6. "merchant_create_request": {
  7. "type": "1",
  8. "merchant_short_name": "添加商户",
  9. "merchant_name": "添加商户",
  10. "email": "12062@gmail.com",
  11. "phone": "18812060000"
  12. },
  13. "sign": "712036C2324D76F2934C44C95A80CEBA"
  14. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <request_type>merchant_create_request</request_type>
  4. <isspid>00058301</isspid>
  5. <pos_seq>2022112500001</pos_seq>
  6. <system_id>8888</system_id>
  7. <merchant_create_request>
  8. <type>1</type>
  9. <merchant_short_name>添加商户</merchant_short_name>
  10. <merchant_name>添加商户</merchant_name>
  11. <email>12062@gmail.com</email>
  12. <phone>18812060000</phone>
  13. </merchant_create_request>
  14. </business_trans>

交易请求报文说明

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节
可选
request_type请求类型String(32)固定值:merchant_create_request必填
system_id系统平台号String(4)由翼码提供必填
isspid商户号String(8)翼码商户号,由翼码提供必填
pos_seq请求流水号String(32)同一个翼码商户号下唯一,不可重复使用,且大于12位必填
merchant_create_request
->type
用户类型String(2)1:企业商户, 2:个体商户, 3:小微商户(无营业执照);
企业/个体商户需调用4.45.企业分账商户开户
小微商户需调用4.43.个人分账商户开户
必填
merchant_create_request
->merchant_short_name
用户简称String(20)用户简称仅支持输入汉字、英文字符、数字必填
merchant_create_request
->merchant_name
用户名称String(50)用户名称不能超过50个字符长度必填
merchant_create_request
->phone
用户手机号String(20)用户手机号必填
merchant_create_request
->email
用户邮箱String(64)用户邮箱可选
merchant_create_request
->send_sms_tag
短信通知String(1)是否发短信通知 1:发送,0:不发送,默认为0可选

交易返回报文

JSON:

  1. {
  2. "response_type": "merchant_create_response",
  3. "isspid": "00058301",
  4. "pos_seq": "2022112500001",
  5. "trans_time": "20221207160923",
  6. "merchant_id": 1000107,
  7. "result": {
  8. "id": "0000",
  9. "comment": "操作成功"
  10. },
  11. "sign": "20896396D9AAE3798E3A9131E84297E4"
  12. }

XML:

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

交易返回报文说明

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

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

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