Powered by GitBook

商户入驻平台化接口

接口说明

清算方需要通过该接口在清算平台帮助商户创建门店信息（仅入驻平台化）。

请求方式

POST

方法名

fshows.liquidation.merchant.create

请求参数

参数	类型	是否必填	最大长度	描述
external_id	String	是	20	服务商的商户编号,由服务商自己定义,该商户编号必须在服务商系统中惟一
name	String	是	64	商户全称,须与商户相关执照一致
alias_name	String	是	32	商户简称,在支付宝、微信支付时展示
service_phone	String	是	64	客服电话
contact_name	String	特殊可选（M3必传）	64	联系人名字，若上传了card_no，business_license，business_license_type，contact_type，其中一个参数，则contact_name必传
contact_phone	String	否	64	联系人电话
contact_mobile	String	否	64	联系人手机号
contact_email	String	否	128	联系人邮箱
category_id	String	是	128	经营类目，类目表点击下载
memo	String	否	512	商户备注
id_card_name	String	是	64	身份证姓名
id_card_num	String	是	18	身份证号码
store_address	String	是	255	店铺地址(同营业执照地址)
id_card_hand_img_url	String	是	255	手持身份证图片
store_front_img_url	String	是	255	商户门头图片
business_license_img_url	String	否	255	营业执照图片
province	String	是	20	省份名称，如：浙江省，省市区名称表点击下载
city	String	是	20	城市名称，如：杭州市
district	String	是	20	区县名称，如：西湖区
card_no	String	特殊可选（M3必传）	32	银行卡号（需保证同持卡人同身份证姓名一致）；若上传了card_no，business_license，business_license_type，type，其中一个参数，则四个参数必传
business_license	String	特殊可选（M3必传）	20	营业执照编号（企业或者个体工商户提供营业执照，事业单位提供事证号）；若上传了card_no，business_license，business_license_type，contact_type，其中一个参数，则四个参数必传
business_license_type	String	特殊可选（M3必传）	20	商户证件类型，取值范围：NATIONAL_LEGAL：(营业执照)；NATIONAL_LEGAL_MERGE：(营业执照(多证合一)；INST_RGST_CTF：(事业单位法人证书)；若上传了card_no，business_license，business_license_type，contact_type，其中一个参数，则四个参数必传
contact_type	String	特殊可选（M3必传）	32	商户联系人类型，取值范围：LEGAL_PERSON：(法人)；CONTROLLER：(实际控制人)；AGENT：(代理人)；OTHER：(其他)；若上传了card_no，business_license，business_license_type，contact_type，其中一个参数，则四个参数必传

请求示例

{"method":"fshows.liquidation.submerchant.create.with.auth",
  "app_id":"2016072300007148",
  "sign":"hq1j1tBCQkJCecJbU1I+9VyRDPyjzBjT6ok7S6QWT72ebJ7nNmTJFy5GLh0Zw9lyciT/1Qd7dDeFRVwqxHW10xzv8qBqjGNq4S1TH1sEukMBk7emkD78javGS0m+6KIEtK1K5gePgqy3HRpxqrD58jqZIOu5FIxY5m5a93CJC/o=",
  "version":"1.0"
  "content" ：{
    "external_id":"105290059990194",
    "name":"xxx信息服务有限公司",
    "alias_name":"xx公司",
    "service_phone":"95188",
    "contact_email":"[email protected]",
    "category_id":"2015110500080520",
    "memo":"商户营业执照编号xxxxx，省市区地址",
    "id_card_name":"测试",
    "id_card_num":"441111199210264231",
    "store_address":"浙江省杭州市余杭区永吉鑫宾馆8201室",
    "store_front_img_url":"xxxxx",
    "id_card_hand_img_url":"xxxxx",
    "province":"广东省",
    "city":"东莞市",
    "district":"东城街道"}

}

返回值

参数	类型	是否必填	最大长度	描述
sub_merchant_id	String	是	20	移动支付平台为商户分配的惟一 ID,商户入驻后,由平台返回
extranal_id	String	是	20	服务商的商户编号,由服务商自己定义,该商户编号必须在服务商系统中惟一
name	String	是	128	商户全称,须与商户相关执照
alias_name	String	是	64	商户简称,在支付宝、微信支
service_phone	String	是	64	客服电话
category_id	String	是	128	经营类目
liquidator_name	String	是	32	所属接入平台服务商的名称
status	String	是	2	商户状态：0.关闭1.开启2.审核不通过3.未审核

返回值示例

成功请求示例:

{ "return_value": {
        "external_id": "105290059990194",
        "liquidator_name": “测试”,
        "service_phone": "95188",
        "name": "xx",
        "sub_merchant_id": "20160812025856021829",
        "category_id": "2015110500080520",
        "alias_name": "xx"
        "status":"1"
    },
    "success": true
}

失败请求示例

{
   "error_code": "-101",
    "error_message": "无效参数",
    "success": false
}

results matching ""

No results matching ""