蚂蚁店铺创建
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/v3/ant/merchant/shop
错误码
公共错误码
业务错误码
| 状态码 | 错误码 | 错误描述 | 解决方案 |
|---|---|---|---|
| 400 | SYSTEM_ERROR | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| 400 | ADDRESS_CITY_CODE_ILLEGAL | 市码非法 | 地址中市码非法 |
| 400 | ADDRESS_DISTRICT_CODE_ILLEGAL | 区码非法 | 地址中区码非法 |
| 400 | ADDRESS_PROVINCE_CODE_ILLEGAL | 省码非法 | 地址中省码非法 |
| 400 | ATTACHMENT_CHECK_FAIL | 附件非 法 | out_door_images、qualifications等字段传入的image_id非法，需传入ant.merchant.expand.indirect.image.upload 接口上传图片后得到的 image_id |
| 400 | ATTACHMENT_TYPE_ILLEGAL | 附件类型不合法 | 附件类型不合法 |
| 400 | ATTACHMENT_URL_NULL | 附件图片为空 | 附件图片不能为空 |
| 400 | BANK_ACCOUNTINSTID_ILLEGAL | 开户行简称校验不合法 | 开户行简称校验不合法 |
| 400 | BANK_ACCOUNTINSTNAME_ILLEGAL | 银行名称校验不合法 | 银行名称校验不合法 |
| 400 | BANK_BRANCH_NAME_ILLEGAL | 银行卡分支机构名称非法 | 银行卡分支机构名称非法 |
| 400 | BRAND_ILLEGAL | 品牌非法 | 品牌非法，品牌id不存在，或店铺类目不在品牌范围内 |
| 400 | BUSINESS_LICENSE_EMPTY | 营业执照为空 | 营业执照为空 |
| 400 | BUSINESS_TIME_ILLEGAL | 营业时间非法 | 请检查business_time字段格式是否正确。尤其请注意时间需要传HH:mm，例如需要传08:00而不是8:00 |
| 400 | CONTACT_PERSON_NAME_NULL | 联系人名称为空 | 联系人名称为空 |
| 400 | CONTACT_WAY_VALUE_NULL | 联系方式 值为空 | 联系方式值为空，可能是店铺的固话或手机二选一必填，也可能是联系人的固话手机email三选一必填 |
| 400 | CTU_INDIRECT_CREATE_FAIL | 风险咨询检测到有风险 | 根据我公司风险监测系统的监测结果，你的账户可能存在风险，暂时不能创建。如有问题请咨询客服。 |
| 400 | GONGAN_CHECK_FAIL | 公安网校验失败 | 公安网校验失败，法人信息有误 |
| 400 | GONGSHANG_CHECK_FAIL | 工商网校验失败 | 工商网校验失败，营业执照号有误 |
| 400 | GONGSHANG_LICENSE_ILLEGAL | 工商网校验营业执照不合法 | 工商网校验营业执照不合法 |
| 400 | INDUSTRY_QUALIFICATION_IS_EMPTY | 行业资质为空 | 行业资质为空 |
| 400 | ISV_NOT_EXIST | 待操作的服务商不存在 | 待操作的服务商不存在 |
| 400 | LOCATION_CHECK_FAIL | 经纬度非法 | 修改经纬度 经度范围-180-180 纬度范围-90-90 |
| 400 | MERCHANT_INPUT_ARGUMENT_ILLEGAL | 输入参数非法 | 输入参数非法. |
| 400 | MERCHANT_NOT_EXIST | 操作的商户不存在 | 操作的商户不存在 |
| 400 | MER_ARGUMENT_ILLEGAL | 入参非法 | 请检查请求参数是否正确 |
| 400 | MER_ARGUMENT_NULL | 参数不能为空 | 参数不能为空 |
| 400 | NOT_ALLOWED_SETTLE | 不允许的进件 | 未经商户ip_role_id授权，不允许进件 |
| 400 | PROFILE_KEY_ILLEGAL | extInfo的key不合法 | extInfo的key不合法，请找对应BD确认 |
| 400 | SETTLED_ACCOUNTBRANCHNAME_EMPTY | 支行信息为空 | 支行信息为空 |
| 400 | SETTLED_ACCOUNTHOLDERNAME_EMPTY | 卡户名为空 | 卡户名为空 |
| 400 | SETTLED_ACCOUNTINSTNAME_EMPTY | 银行名称为空 | 银行名称为空 |
| 400 | SETTLED_BANKCARD_NO_IS_EMPTY | 结算银行卡号为空 | 结算银行卡号为空 |
| 400 | SETTLED_BIZ_ADDRESS_ILLEGAL | 经营地址不合法 | 经营地址不合法，可能是对象为空，或其中省、市、区、详细地址为空 |
| 400 | SETTLED_CARD_ACCOUNTINSTID_EMPTY | 开户行简称为空 | 开户行简称为空 |
| 400 | SETTLED_CARD_ACCOUNTTYPE_EMPTY | 卡类型不能为空 | 卡类型不能为空 |
| 400 | SETTLED_CARD_ACCOUNTTYPE_ILLEGAL | 卡类型非法 | 卡类型非法 |
| 400 | SETTLED_OUTDOORIMAGE_EMPTY | 进件门头照为空 | 进件门头照为空 |
| 400 | SETTLED_USAGETYPE_ILLEGAL | 账号使用类型非法 | 账号使用类型非法 |
| 400 | SETTLED_USAGETYPE_IS_EMPTY | 账号使用类型为空 | 账号使用类型为空 |
| 400 | SHOP_ACCOUNT_NO_IS_ILLEGAL | 收款账户非法 | 收款账户非法 |
| 400 | SHOP_ALREADY_EXIST | 门店已存在 | 门店已存在，该商户下已有一家相同store_id的门店，或者已存在一家名称+地址相同的门店 |
| 400 | SHOP_ALREADY_EXIST | 门店已存在 | 门店已存在，该商户下已有一家相同store_id的门店，或者已存在一家名称+地址相同的门店 |
| 400 | SHOP_AUDIT_REJECT | 门店审核不通过 | 门店审核不通过，请填写线下真实可找到的门店名称以及地址信息 |
| 400 | SHOP_CATEGORY_IS_EMPTY | 门店类目不能为空 | 门店类目不能为空 |
| 400 | SHOP_CATEGORY_IS_ILLEGAL | 门店类目非法 | 门店类目非法 |
| 400 | SHOP_NOT_EXIST | 门店不存在 | 门店不存在 |
| 400 | SHOP_SHOPNAME_IS_EMPTY | 店铺名称为空 | 店铺名称为空 |
| 400 | SHOP_SHOPNO_IS_EMPTY | 店铺编号store_id为空 | 店铺编号store_id为空 |
| 400 | USER_ILLEGAL | 用户不合法 | 用户不合法，请确保ip_role_id存在且实名认证 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/v3/ant/merchant/shop' \
--header 'authorization: ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign' \
--header 'alipay-request-id: $requestid' \
--header 'Content-Type: application/json' \
--data-raw '{
"business_address":{
"city_code":"371000",
"district_code":"371002",
"address":"万塘路18号黄龙时代广场B座",
"province_code":"370000",
"poiid":"B0FFIVU189",
"longitude":"120.760001",
"latitude":"60.270001",
"type":"BUSINESS_ADDRESS"
},
"shop_category":"B0001",
"store_id":"NO0001",
"shop_type":"01",
"ip_role_id":"2088301155943087",
"shop_name":"支付宝（西溪路店）",
"legal_name":"支小宝",
"legal_cert_no":"100100198811110001",
"license_auth_letter_image":"营业执照授权函图片id",
"cert_no":"9133010608210550XR",
"out_door_images":[
"c6c0c7a1-b9d5-4e5d-b9d4-9eed39f00e65.jpg"
],
"qualifications":[
{
"industry_qualification_type":"301",
"industry_qualification_image":"c6c0c7a1-b9d5-4e5d-b9d4-9eed39f00e65.jpg"
}
],
"cert_type":"201",
"cert_name":"支付宝东门小卖铺",
"cert_image":"营业执照图片id",
"contact_phone":"010-62286228",
"contact_mobile":"13901390139",
"scene":"PARK",
"ext_infos":[
{
"key_name":"SHOP_SLOGAN",
"value":"我是标语"
}
],
"settle_alipay_logon_id":"demo@163.com",
"business_time":[
{
"week_day":1,
"open_time":"09:30",
"close_time":"22:00"
}
],
"contact_infos":[
{
"name":"张三",
"tag":[
"06"
],
"phone":"0571-85022088",
"mobile":"13888888888",
"email":"user@domain.com",
"type":"LEGAL_PERSON",
"id_card_no":"110000199001011234"
}
],
"memo":"备注",
"brand_id":"20181026000001",
"biz_cards":[
{
"account_holder_name":"张三",
"account_no":"6214855710610408",
"account_inst_province":"浙江省",
"account_inst_city":"杭州市",
"account_branch_name":"招商银行杭州高新支行",
"usage_type":"01",
"account_type":"DC",
"account_inst_name":"招商银行",
"account_inst_id":"CMB",
"bank_code":"103290003044"
}
]
}'响应示例响应示例
{
"order_id": "2018012000502000000005130266",
"exist_shop_id": "2022102800077000000039913046"
}请求参数
Header 参数
authorization
string
必需
示例值:
ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign
alipay-request-id
string
必需
示例值:
$requestid
Content-Type
string
必需
示例值:
application/json
Body 参数application/json