交易请求报文
JSON:
{
"request_type": "merchant_entregister_request",
"isspid": "00058301",
"pos_seq": "2022112500001",
"system_id": "8888",
"merchant_entregister_request": {
"merchant_id": "1000105",
"merchant_name": "xx公司",
"license_code": "xx",
"license_begin_date": "20170718",
"license_end_date": "20170718",
"license_validity_type": "1",
"license_province_code": "350000",
"license_city_code": "350100",
"license_area_code": "350105",
"license_address": "xx",
"identity_type": "1",
"legal_name": "xx",
"identity_no": "3501051963060xxxxx",
"identity_begin_date": "19630607",
"identity_end_date": "19630607",
"identity_validity_type": "1",
"contact_name": "xx",
"contact_phone": "18506050000",
"contact_email": "18506050000@gmail.com",
"license_photo": "11",
"cert_photo_a": "11",
"cert_photo_b": "11"
},
"sign": "712036C2324D76F2934C44C95A80CEBA"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<request_type>merchant_entregister_request</request_type>
<isspid>39493002</isspid>
<pos_seq>1511300000001</pos_seq>
<system_id>8888</system_id>
<merchant_entregister_request>
<merchant_id>1000105</merchant_id>
<merchant_name>xx公司</merchant_name>
<license_code>xx</license_code>
<license_begin_date>20170718</license_begin_date>
<license_end_date>20170718</license_end_date>
<license_validity_type>1</license_validity_type>
<license_province_code>350000</license_province_code>
<license_city_code>350100</license_city_code>
<license_area_code>350105</license_area_code>
<license_address>xx</license_address>
<identity_type>1</identity_type>
<legal_name>xx</legal_name>
<identity_no>350105196xxxxxx</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_phone>18506050000</contact_phone>
<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>
</merchant_entregister_request>
</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 | 分账商户id | String | 分账商户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:
{
"response_type": "merchant_entregister_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_entregister_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_entregister_response | 必填 |
isspid | 商户号 | String(8) | 翼码商户号,由翼码提供 | 必填 |
pos_seq | 请求流水号 | String(32) | 请求流水号 | 可选 |
trans_time | 交易时间 | String(14) | 交易时间,格式:yyyyMMddHHmmss | 必填 |
result ->id | 响应码 | String(4) | 翼码平台返回的处理结果,0000-成功,其它失败,错误信息说明见“响应码解释”字段 | 必填 |
result ->comment | 响应码解释 | String(64) | 响应码对应中文注解,用于显示提示 | 必填 |
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!