商户入驻接口
接口说明
- 渠道方需要通过该接口在morp帮助商户录入信息(仅入驻morp);
- 商户图片信息需要通过<图片批量上传接口>来上传,将获得的fileId作为对应图片参数的值;
- 商户类型等级配置表,详情参见;注(请求参数中的是否必填,按等级配置表中的必填项来确定)
- 建议调用图片批量上传接口后,先去调用图片批量查询接口,确认图片状态后,再去调用商户入驻接口
请求方式
方法名
- fshows.liquidation.merchant.enter
请求参数
参数 |
类型 |
是否必填 |
最大长度 |
描述 |
external_id |
String |
是 |
32 |
渠道方的商户编号,由渠道方自己定义,该商户编号必须在渠道方系统中惟一 |
merchant_type |
Integer |
是 |
1 |
商户类型:1-小微,2-个体户,3企事业 |
merchant_name |
String |
是 |
255 |
商户全称,须与商户相关执照一致 |
alias_name |
String |
是 |
64 |
商户简称,在支付宝、支付时展示 |
service_phone |
String |
是 |
16 |
客服电话 |
store_address |
String |
是 |
255 |
商户地址 |
province_code |
String |
是 |
32 |
省级编码 |
city_code |
String |
是 |
32 |
市级编码 |
district_code |
String |
否 |
32 |
区级编码,特殊地区(香港,澳门)非必填,其他地区为必填 |
category_id |
String |
是 |
4 |
经营类目,类目表点击下载 |
store_front_img |
String |
否 |
|
商户门头照·,通过图片批量上传接口,成功上传后返回的fileid值 |
checkstand_pic |
String |
否 |
|
收银台照片,通过图片批量上传接口,成功上传后返回的fileid值 |
indoor_pic |
String |
否 |
|
店内环境照,通过图片批量上传接口,成功上传后返回的fileid值 |
business_license_type |
String |
否 |
32 |
商户证件类型:NATIONAL_LEGAL(营业执照),NATIONAL_LEGAL_MERGE(营业执照多证合一) |
business_license |
String |
否 |
32 |
营业执照号 |
business_license_img |
String |
否 |
|
营业执照照片 |
business_expiry |
String |
否 |
128 |
营业执照有效期,示例:2018-01-01-2019-02-02,年月日前面有0的一定要加上 |
business_time |
String |
否 |
128 |
商户营业时间,示例:(0:00或00:00)-(0:00或00:00)或- |
longitude |
String |
否 |
50 |
商户地址经度 |
latitude |
String |
否 |
50 |
商户地址维度 |
id_card_name |
String |
是 |
32 |
持卡人姓名 |
id_card_num |
String |
是 |
18 |
法人身份证 |
id_card_hand_img |
String |
否 |
|
手持身份证照片 |
id_card_heads_pic |
String |
否 |
|
身份证正面照 |
id_card_tails_pic |
String |
否 |
|
身份证反面照 |
phone |
String |
否 |
16 |
电话 |
mobile |
String |
否 |
16 |
手机 |
email |
String |
否 |
32 |
邮箱 |
card_type |
Integer |
是 |
1 |
结算卡类型:0:非法人,1:法人,2:公司 |
is_public_account |
Integer |
是 |
1 |
账户类型:1.对公 0.对私 |
user_name |
String |
是 |
64 |
结算卡开户名 |
bank_id_card_num |
String |
否 |
18 |
非法人开户人身份证号 |
author_certificate_pic |
String |
否 |
|
非法人清算授权函 |
bank_no |
String |
是 |
32 |
银行卡号 |
bank_card_pic |
String |
否 |
|
银行卡正面照 |
open_bank |
String |
是 |
64 |
开户行 |
super_bank_no |
String |
否 |
64 |
超级网银号 |
united_bank_no |
String |
特殊选填 |
64 |
联行行号(对公账号必填) |
settle_tag |
Integer |
否 |
1 |
结算标识:0:银联通道,1:任意通道(默认) |
audit_type |
Integer |
否 |
1 |
审核标识:1:加急,0:普通 |
memo |
String |
否 |
512 |
备注 |
请求示例
{
'app_id': '20180915113601238',
'version': '1.0',
'method': 'fshows.liquidation.merchant.enter',
'content': '{"external_id": "20181031171551317309","merchant_type": "3", "merchant_name": "潘豆豆餐厅", "alias_name": "潘豆豆餐厅", "service_phone": "17858936130", "category_id": "5812", "store_address": "浙江省杭州市西湖区", "province_code": "330000", "city_code": "330100", "district_code": "330102", "store_front_img": "20181030133651025640", "checkstand_pic": "20181030133651022122", "indoor_pic": "20181030133651026915", "business_license_type": "NATIONAL_LEGAL", "business_license": "420103000057404", "business_license_img": "20181030133651022027", "business_expiry": "2018\年08\月31-2020\年09\月01\日", "business_time": "09:00-24:00", "longitude": "120.19", "latitude": "30.26", "id_card_name": "\胖\豆\豆", "id_card_num": "421087198810035013", "id_card_hand_img": "20181030133639025926", "id_card_heads_pic": "20181030133639025467", "id_card_tails_pic": "20181030133639020300", "phone": "17858936130", "mobile": "15990000002", "email": "[email protected]", "card_type": "2", "is_public_account": "1", "user_name": "\胖\豆\豆", "bank_id_card_num": "421087198810035013", "author_certificate_pic": "20181030133639024171", "bank_no": "4210985632145649486313123", "bank_card_pic": "20181030133619023756", "open_bank": "\工\商\银\行\红\会\支\行", "super_bank_no": "888888", "united_bank_no": "123456", "settle_tag": "1", "audit_type": "0", "memo": "\中\餐\厅"}',
'sign': 'gu4bvfwlUDhKR9VBonrg/2X+kJjYGYLgECngkZVoXmJrpNxShGKzGbQhWVgie62cpfQPoukllh2J3O35L4mWhg=='
}
返回值
参数 |
类型 |
最大长度 |
描述 |
store_id |
String |
20 |
移动支付平台为商户分配的惟 一 ID,商户入驻后,由平台返回 |
status |
String |
1 |
返回状态:一般为:1.审核通过 3.待审核 |
msg |
String |
128 |
入驻的结果 |
返回值示例
成功返回示例:
{
"return_value": {
"store_id": "20180914152243015571",
"status": 3,
"msg": "商户入驻成功,待审核!"
},
"success": true
}
失败返回示例
{
"error_code": "-101",
"error_message": "无效参数",
"success": false
}
{
'error_code': '-103',
'error_message': '门头照不存在或已经使用',
'success': False
}