综合体支付即积分的 ISV接入模式是否要求商圈企业支付宝入驻开放平台
结论
在文档所述的 ISV 接入模式下,商圈运营主体通常仍需使用企业支付宝账号入驻支付宝开放平台,并通过该账号创建商圈应用。即使 ISV 已入驻开放平台,第三方应用也已上线,商圈主体仍需完成这一步。
需要入驻的是商圈运营主体,并非所有受邀加入商圈的门店或商家。如果多个商圈由同一主体运营,并共用一个企业支付宝账号,通常不必为每个商圈重复入驻。是否需要分别创建应用,则要以支付即积分产品后台和对应接入文档为准。
为什么商圈主体仍需入驻
ISV 与商圈运营主体的职责不同:
- ISV 开发第三方应用、提供技术服务,并发起商家接入或授权。
- 商圈运营主体创建并持有商圈应用,确认业务主体和相关协议。
- 商圈内商家通过邀请、授权等方式加入,不需要自行创建商圈应用。
ISV 的开放平台账号用于确认系统和技术服务的提供方,商圈企业账号则用于确认商圈业务的运营及责任主体,两者不能相互代替。
如果使用商圈企业支付宝账号登录开放平台时看到“请先入驻开放平台”,通常表示当前流程要求该企业先成为开放平台开发者或商家主体。这不代表第三方应用申请失败,也不表示 ISV 资质尚未生效。
推荐接入步骤
建议按以下顺序操作:
- ISV 使用自己的企业支付宝账号入驻开放平台。
- ISV 创建并配置第三方应用,申请支付即积分所需的能力。
- 商圈运营主体使用自己的企业支付宝账号入驻开放平台。
- 商圈运营主体通过产品入口选择“商家应用模板”,创建商圈应用。
- ISV 从第三方应用侧发起邀请或授权。
- 商圈运营主体确认授权,ISV 取得相应的授权凭证。
- ISV 使用第三方应用身份和商家授权令牌调用后续接口。
- 商圈运营主体继续邀请符合条件的商家加入商圈。
如果后台没有“商家应用模板”入口,或者创建应用时无法选择支付即积分能力,可以依次检查:
- 当前登录的是否为商圈运营主体的企业支付宝账号;
- 企业实名认证和开放平台入驻是否已经完成;
- 当前账号是否具有管理员权限;
- 第三方应用是否已申请相应的产品能力;
- 商圈主体的所属行业、签约状态或所在地区是否符合产品开放条件。
授权调用示例
账号入驻和商圈应用创建都需要在开放平台后台完成,没有可替代这些操作的 API。商家完成授权后,ISV 调用业务接口时需要携带该商家的 app_auth_token。
下面的示例只用于说明授权令牌的传入位置。具体请求类和接口名称应以支付即积分当前的官方文档为准:
AlipayClient alipayClient = new DefaultAlipayClient(
gatewayUrl,
isvAppId,
isvPrivateKey,
"json",
"UTF-8",
alipayPublicKey,
"RSA2"
);
SomeAlipayRequest request = new SomeAlipayRequest();
request.setBizContent("""
{
"business_field": "business_value"
}
""");
SomeAlipayResponse response = alipayClient.execute(
request,
null,
merchantAppAuthToken
);
if (!response.isSuccess()) {
throw new IllegalStateException(
response.getCode() + ": " + response.getSubMsg()
);
}
其中:
isvAppId是 ISV 第三方应用的app_id;merchantAppAuthToken是商圈运营主体授权后取得的app_auth_token;app_auth_token表示商家的授权关系,不能用 ISV 自己的访问凭证代替;- 请求类、业务参数和接口权限必须与实际开通的支付即积分能力一致。
注意事项
区分商圈主体和入圈商家
通常需要创建商圈应用的是商圈运营主体。普通商家受邀加入商圈后,是否还需入驻开放平台,要根据具体的邀请方式、签约要求和产品规则判断,不能据此认为每家门店都必须创建开放平台应用。
使用与运营主体一致的企业账号
创建商圈应用时,应使用实际商圈运营主体的企业支付宝账号。如果使用 ISV 自己的账号或其他无关企业的账号代建,后续可能会在授权、签约、结算、主体校验或运营权限等环节遇到问题。
入驻通常按账号完成
同一个企业支付宝账号完成开放平台入驻后,通常不会因为创建多个商圈而需要重复入驻。不同的企业主体或企业支付宝账号,一般需要分别完成入驻和实名认证。
以后台实际入口为准
支付即积分的开放范围、应用模板名称和接入路径可能发生调整。如果控制台中的实际流程与文档不一致,请保留第三方应用 app_id、商圈企业账号、页面提示和操作截图,并向支付宝开放平台技术支持确认当前账号适用的接入路径。在确认前不要反复创建应用,以免产生多个无效应用或建立错误的主体关系。
备注:内容仅供参考。
