支付宝—商户入驻接口
接口说明
- 清算方需要通过该接口入入驻支付宝商户。
调用本接口前,请先调用<基础-商户入驻平台化接口>完成平台化的商户注册;
请求参数中的store_id由<基础-商户入驻平台化接口>应答参数返回sub_merchant_id;
可更新已入驻平台化商户的商户信息,然后去入驻支付宝。
请求方式
- POST
方法名
- fshows.alipay.merchant.create
请求参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 |
---|---|---|---|---|
store_id | String | 是 | 20 | 平台化商户号 |
name | String | 否 | 64 | 商户全称,须与商户相关执照一致 |
alias_name | String | 否 | 32 | 商户简称,在支付宝、微信支付时展示 |
service_phone | String | 否 | 64 | 客服电话 |
contact_name | String | 否 | 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 | 店铺地址(同营业执照地址) |
province | String | 否 | 20 | 省份名称,如:浙江省,省市区名称表点击下载 |
city | String | 否 | 20 | 城市名称,如:杭州市 |
district | String | 否 | 20 | 区县名称,如:西湖区 |
card_no | String | 否 | 32 | 银行卡号(需保证同持卡人同身份证姓名一致);若上传了card_no,business_license,business_license_type,type,其中一个参数,则四个参数必传 |
business_license | String | 否 | 20 | 营业执照编号(企业或者个体工商户提供营业执照,事业单位提供事证号);若上传了card_no,business_license,business_license_type,contact_type,其中一个参数,则四个参数必传 |
business_license_type | String | 否 | 20 | 商户证件类型,取值范围:NATIONAL_LEGAL:(营业执照);NATIONAL_LEGAL_MERGE:(营业执照(多证合一);INST_RGST_CTF:(事业单位法人证书);若上传了card_no,business_license,business_license_type,contact_type,其中一个参数,则四个参数必传 |
contact_type | String | 否 | 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室",
"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
}