商户入驻接口

接口说明

  • 渠道方需要通过该接口在morp帮助商户录入信息(仅入驻morp);
  • 商户图片信息需要通过<图片批量上传接口>来上传,将获得的fileId作为对应图片参数的值;
  • 商户类型等级配置表,详情参见;注(请求参数中的是否必填,按等级配置表中的必填项来确定)
  • 建议调用图片批量上传接口后,先去调用图片批量查询接口,确认图片状态后,再去调用商户入驻接口

请求方式

  • POST

方法名

  • 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
}

results matching ""

    No results matching ""