支付宝商户签约接口
接口说明
- 调用本接口前,请先调用<基础-商户入驻接口>并通过审核完成商户进件到morp。
请求方式
方法名
- fshows.alipay.merchant.create
请求参数
参数 |
类型 |
是否必填 |
最大长度 |
描述 |
store_id |
String |
是 |
20 |
移动支付平台为商户分配的惟 一 ID,商户入驻后,由平台返回 |
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,其中一个参数,则四个参数必传 |
card_name |
String |
否 |
64 |
银行卡姓名 |
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.alipay.merchant.create",
"app_id":"2016072300007148",
"sign":"hq1j1tBCQkJCecJbU1I+9VyRDPyjzBjT6ok7S6QWT72ebJ7nNmTJFy5GLh0Zw9lyciT/1Qd7dDeFRVwqxHW10xzv8qBqjGNq4S1TH1sEukMBk7emkD78javGS0m+6KIEtK1K5gePgqy3HRpxqrD58jqZIOu5FIxY5m5a93CJC/o=",
"version":"1.0"
"content" :{
"store_id":"105290059990194",
"name":"齐国县北国饭店",
"alias_name":"北国饭店",
"service_phone":"95188",
"contact_email":"[email protected]",
"category_id":"2015110500080520",
"memo":"中餐厅",
"id_card_name":"潘豆豆",
"id_card_num":"441111199210264231",
"store_address":"浙江省杭州市余杭区紫金港路256号",
"province":"浙江省",
"city":"杭州市",
"district":"余杭区"}
}
返回值
参数 |
类型 |
最大长度 |
描述 |
store_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.未审核 |
alipay_id |
String |
64 |
支付宝子商户号 |
返回值示例
成功返回示例:
{ "return_value": {
"external_id": "105290059990194",
"liquidator_name": "潘豆豆餐饮有限集团",
"service_phone": "95188",
"name": "潘豆豆",
"store_id": "20160812025856021829",
"category_id": "2015110500080520",
"alias_name": "北国饭店"
"status":"1"
'alipay_id': '2088000410959954'
},
"success": true
}
失败返回示例:
{
"error_code": "-101",
"error_message": "无效参数",
"success": false
}