1. 保存商户
用户通过web端或APP完善商户信息接口
JSON
POST
| 参数名称 | 约束 | 类型 | 长度 | 描述 | 取值说明 |
|---|---|---|---|---|---|
| app_id | 1 | String | 30 | 应用ID | Api服务分配 |
| transaction_id | 1 | String | 30 | 请求流水号 | 不能重复 1000000000+YYYYMMDDhhmmss+6位序列 |
| sign | 1 | String | - | 签名 | 请参考签名说明 |
| req_time | 1 | String | - | 请求时间 | YYYYMMDDhhmmss |
| 父参数名称 | 参数名称 | 约束 | 类型 | 长度 | 描述 | 取值说明 |
|---|---|---|---|---|---|---|
| - | businessStore | object | - | - | 商户基本节点 | - |
| businessStore | userId | String | - | 30 | 用户ID | - |
| businessStore | name | 1 | String | 50 | 商户名称 | - |
| businessStore | address | 1 | String | 200 | 商户地址 | - |
| businessStore | password | ? | String | 200 | 密码 | MD5加密密码 |
| businessStore | tel | 1 | String | 11 | 联系电话 | - |
| businessStore | storeTypeCd | 1 | String | 10 | 店铺种类 | 详见表store_type定义 |
| businessStore | nearbyLandmarks | 1 | String | 200 | 地标 | 地标,如王府井北60米 |
| businessStore | mapX | 1 | String | 20 | 地区 x坐标 | - |
| businessStore | mapY | 1 | String | 20 | 地区 y坐标 | - |
| - | businessStoreAttr | ? | object | - | 商户属性 | - |
| businessStoreAttr | specCd | 1 | String | 12 | 属性编码 | 商户服务提供 |
| businessStoreAttr | value | 1 | String | 50 | 属性值 | - |
| - | businessStoreCerdentials | ? | object | - | 商户证件 | - |
| businessStoreCerdentials | credentialsCd | 1 | String | 12 | 证件类型 | 对应于 credentials表 |
| businessStoreCerdentials | value | 1 | String | 50 | 证件号码 | - |
| businessStoreCerdentials | validityPeriod | 1 | String | - | 有效期 | 格式为YYYY-MM-DD hh:mm:ss 例如:2018-07-07 11:04:00 如果是长期有效 写成 3000-01-01 00:00:00 |
| businessStoreCerdentials | positivePhoto | 1 | String | 100 | 正面照片 | 照片存储大数据中路径 |
| businessStoreCerdentials | negativePhoto | 1 | String | 100 | 反面照片 | 照片存储大数据中路径 |
当http返回状态不为200 时请求处理失败 body内容为失败的原因
当http返回状态为200时请求处理成功,body内容为返回内容,
请求头信息:
Content-Type:application/json
USER_ID:1234
APP_ID:8000418004
TRANSACTION_ID:10029082726
REQ_TIME:20181113225612
SIGN:aabdncdhdbd878sbdudn898
请求报文:
{
"businessStore": {
"userId": "30518940136629616640",
"name": "齐天超时(王府井店)",
"address": "青海省西宁市城中区129号",
"password": "ERCBHDUYFJDNDHDJDNDJDHDUDHDJDDKDK",
"tel": "15897089471",
"storeTypeCd": "M",
"nearbyLandmarks": "王府井内",
"mapX": "101.801909",
"mapY": "36.597263"
},
"businessStoreAttr": [{
"specCd":"1001",
"value":"01"
}],
"businessStoreCerdentials":[{
"credentialsCd":"300200900001",
"value":"632126XXXXXXXX2011",
"validityPeriod":"3000-01-01",
"positivePhoto":"1234567.jpg",
"negativePhoto":""
}]
}
返回报文:
状态码为 200
成功