交易请求报文
JSON:
{
"request_type": "merchant_entmodify_request",
"isspid": "00058301",
"pos_seq": "2022112500001",
"system_id": "8888",
"merchant_entmodify_request": {
"merchant_id": "100010511",
"license_begin_date": "20170718",
"license_end_date": "20170718",
"license_validity_type": "1",
"license_address": "xx",
"legal_name": "xx",
"identity_no": "35010519630607xxxx",
"identity_begin_date": "19630607",
"identity_end_date": "19630607",
"identity_validity_type": 1,
"contact_name": "xx",
"contact_email": "18506050000@gmail.com",
"license_photo": "11",
"cert_photo_a": "11",
"cert_photo_b": "11",
"license_province_code": "420000",
"license_city_code": "420000",
"license_area_code": "420000",
"contact_phone": "18506050000",
"phone": "18812060000",
"email": "12062@gmail.com",
"send_sms_tag": "0"
},
"sign": "712036C2324D76F2934C44C95A80CEBA"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<request_type>merchant_entmodify_request</request_type>
<isspid>00058301</isspid>
<pos_seq>2022112500001</pos_seq>
<system_id>8888</system_id>
<merchant_entmodify_request>
<merchant_id>100010511</merchant_id>
<license_begin_date>20170718</license_begin_date>
<license_end_date>20170718</license_end_date>
<license_validity_type>1</license_validity_type>
<license_address>xx</license_address>
<legal_name>xx</legal_name>
<identity_no>35010519630607xxxx</identity_no>
<identity_begin_date>19630607</identity_begin_date>
<identity_end_date>19630607</identity_end_date>
<identity_validity_type>1</identity_validity_type>
<contact_name>xx</contact_name>
<contact_email>18506050000@gmail.com</contact_email>
<license_photo>11</license_photo>
<cert_photo_a>11</cert_photo_a>
<cert_photo_b>11</cert_photo_b>
<license_province_code>420000</license_province_code>
<license_city_code>420000</license_city_code>
<license_area_code>420000</license_area_code>
<contact_phone>18506050000</contact_phone>
<phone>18812060000</phone>
<email>12062@gmail.com</email>
<send_sms_tag>0</send_sms_tag>
</merchant_entmodify_request>
</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 | 分账商户id | String | 分账商户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 | 可选 |
merchant_entmodify_request ->phone | 用户手机号 | String(11) | 用户手机号 | 可选 |
merchant_entmodify_request | 用户邮箱 | String(64) | 用户邮箱 | 可选 |
merchant_entmodify_request ->send_sms_tag | 短信通知 | String(1) | 是否发短信通知 1:发送,0:不发送,默认为0 | 可选 |
交易返回报文
JSON:
{
"response_type": "merchant_entmodify_response",
"isspid": "00058301",
"pos_seq": "2022112500001",
"trans_time": "20221207154725",
"result": {
"id": "0000",
"comment": "操作成功"
},
"sign": "03B62B8B16844549FFF01F4659B4AE0A"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<response_type>merchant_entmodify_response</response_type>
<isspid>00058301</isspid>
<pos_seq>2022112500001</pos_seq>
<trans_time>20090405010104</trans_time>
<result>
<id>0000</id>
<comment>成功</comment>
</result>
</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) | 响应码对应中文注解,用于显示提示 | 必填 |
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!