更新时间：2025-03-12 15:17:44文档更新记录 >配置项检测工具收藏订阅更新我的文档设置接入检测（即可查看检测结果）若有未通过的接入检测项，接口将无法调通去登录返回文档完成 后，开发者可根据如下指引快速完成蚂蚁门店（支付宝门店）创建等操作。1 第一步：上传图片资料开发者可调用 上传门店门头照和营业执照等图片获取 image_id，可在创建门店时以下参数中传入对应图片 id（image_id）。●out_door_images：店铺门头照。●industry_qualification_image：商家行业资质图片。●cert_image：营业执照图片。●license_auth_letter_image：营业执照授权函。2 第二步：创建门店2.1 接口调用流程2.2 创建门店开发者可调用 ant.merchant.expand.shop.create（蚂蚁店铺创建接口）创建蚂蚁门店（即支付宝店铺）。需注意类目 id（shop_category）为 文件中 二级门店类目。注意：仅服务商可通过接口或 查看/管理 代间连商户创建的门店 信息，间连商家自身无法查看及管理。2.2.1 示例代码重要入参说明●business_address：必填，店铺经营地址，省市编码等信息 或进入 查看。○city_code：必填，城市编码。○district_code：必填，区县编码。○address：必填，地址。商家详细经营地址或人员所在地点。○province_code：必填，省份编码。○poiid：可选，高德兴趣点 id。可通过如下两种方式获取：■直接使用访问高德地图的 进行搜索位置，url 链接后 id 的值即为 poiid ，例如：搜索 蚂蚁 c 空间，链接为 https://ditu.amap.com/search?id=b0ffiu3ql4&city=510107&geoobj=104.055382|30.538725|104.070832|30.546159&query_type=idq&query=蚂蚁c空间&zoom=17，其中 id 属性值 b0ffiu3ql4 即为 poiid 值；■使用 提供的 api 通过关键字搜索、周边搜索、多边形搜索等筛选机制获取。○longitude：可选，经度，浮点型, 小数点后最多保留 6 位。以高德坐标系为准。○latitude：可选，纬度，浮点型,小数点后最多保留 6 位。以高德坐标系为准。●shop_category：必填，店铺类目 id 为 文件中 二级门店类目。○若店铺提交后需要审核的，可通过创建店铺接口返回的 order_id，通过 查询店铺审核状态。○店铺审核通过消息支付宝将调用 发送至对应小程序的 应用网关地址。消息通知详情可查看文末 消息通知。○查询店铺审核驳回原因支付宝将调用 ant.merchant.expand.shop.save.rejected（店铺保存拒绝消息接口）发送至对应小程序的 应用网关地址。○审核未通过可查看下文 门店管理 > 店铺修改 修改提交的门店创建信息。●store_id：必填，门店编号。表示该门店在该商家角色 id（直连 pid，间连 smid）下，由商家自己定义的外部门店编号。●shop_type：必填，店铺经营类型。○01：表示直营。○02：表示加盟。●shop_name：必填，店铺名称。○直连开店要保证全局店铺名称 地址唯一。○间连开店要保证服务商 pid 下店铺名称 地址唯一。●ip_role_id：必填，商家角色 id，表示将要开的店属于哪个商家角色。○对于直连开店场景，填写商家 pid。○对于间连开店场景（线上、线下、直付通），填写商家 smid。○iot 设备三绑定场景统一填写商家 pid。●out_door_images：可选，门头照 id。●qualifications：可选，行业特殊资质。○industry_qualification_type：商家行业资质类型，具体值 。●接口中所有图片资料需调用 上传。更多参数详情可查看 ant.merchant.expand.shop.create（蚂蚁店铺创建接口）。2.3 创建标准门店通过门店名称、地址、省市区县、行业类目接入参数录入，可以创建门店并生成门店 id（shopid）。2.3.1 示例代码2.4 申请单查询（可选）开发者创建店铺为需审核店铺时，可调用 通过上文 ant.merchant.expand.shop.create（蚂蚁店铺创建接口）返回的申请单 id（order_id ）查询创建门店审核状态。2.4.1 示例代码3 第三步：门店管理门店创建成功后可在 pc 后台管理门店信息，本功能创建门店为 支付宝门店，下载店铺收款码等操作。商家可在 > 运营中心 > 其他 管理门店；服务商可在 管理代商家创建的门店。也可使用如下接口完成门店维护。注意：●创建门店成功后可能存在网络延迟，pc 后台管理页面可能会延迟显示门店信息。●仅服务商可通过接口或 查看/管理 代间连商户创建的门店 信息，间连商家自身无法查看及管理。 3.1 店铺修改开发者可调用 ant.merchant.expand.shop.modify（修改蚂蚁店铺接口）修改创建店铺提交信息。注意：●若某项参数修改前已存在，修改时未传入会保留已有值。●每次修改门店信息都会生成新的申请单 id（order_id）。3.2 查询门店详情开发者可调用 查询已创建的蚂蚁门店详情。重要入参说明：●shop_id：蚂蚁店铺 id。填写本参数的话，store_id 和 ip_role_id 可以不填。若不传 shop_id，则 ip_role_id 与 store_id 均必填。●store_id：门店编号，表示该门店在该商家角色 id（账号 pid）下，由商家自己定义的外部门店编号。关店接口中，若未传 shop_id，则本字段与 ip_role_id 均必填。●ip_role_id：商家角色 id（即商家 pid），表示该门店属于哪个商家角色，若不传 shop_id，则本字段与 store_id 均必填。3.3 内部编号查询通过门店 id 查询申请单信息。3.4 外部编号查询通过外部门店编号与商家角色查询申请单信息。3.5 查询门店列表开发者可调用 查询已创建的门店列表。重要入参说明：●ip_role_id：商家角色 id（即商家 pid），表示该门店属于哪个商家角色。●page_num：查询页数。●page_size：每页查询大小，限制 100 以内。3.6 关闭店铺商家可调用 关闭已创建蚂蚁店铺。3.6.1 示例代码4 审核消息通知商家添加 蚂蚁门店管理 功能后将自动订阅 与 ant.merchant.expand.shop.save.rejected（店铺保存拒绝消息接口），支付宝将发送创建门店审核信息至对应小程序的 应用网关地址。4.1 审核通过消息示例更多参数详情可查看 。注意：●服务商收到店铺保存审核通过消息，说明门店已创建成功。●通过接口和平台查看到的店铺状态（比如审核中），是指 名称 地址 经纬度 的真实性审核。●店铺状态不影响交易支付场景的使用（比如分门店收单，账单查看），但会影响到营销推广、投放场景的使用（比如附近发券）。4.2 审核失败消息示例说明：card_alias_no：卡编号，仅直付通场景返回，其它场景无需关注。更多参数详情可查看 ant.merchant.expand.shop.save.rejected（店铺保存拒绝消息接口）。4.3 支付宝消息投递重试策略一般情况下支付宝将在 25 小时以内完成 8 次通知。除了第一次是实时投递外，后续的每次重试都会间隔一段时间，间隔频率一般是：2m,10m,10m,1h,2h,6h,15h（第二次消息投递是在第一次投递失败后的 2 分钟；第三次投递是在第二次投递失败后的 10 分钟，以此类推）。注意：该策略仅供参考，重试策略仅适用于目前的大部分消息场景，蚂蚁集团会根据负载以及业务规则动态调整策略，请勿依赖此策略做任何业务强依赖。更多蚂蚁消息详情可查看 from 蚂蚁消息服务使用。5 店铺增加运营收单账号（可选）创建完门店之后，可选配置运营收单账号，此时需要调用 完成配置。5.1 示例代码6 商户 mcc 信息查询（可选）需要查询 mcc 时，调用 。6.1 示例代码
