PAYATHON 2026

综合体支付即积分的 ISV接入模式是否要求商圈企业支付宝入驻开放平台

支付老李

结论

在文档所述的 ISV 接入模式下,商圈运营主体通常仍需使用企业支付宝账号入驻支付宝开放平台,并通过该账号创建商圈应用。即使 ISV 已入驻开放平台,第三方应用也已上线,商圈主体仍需完成这一步。

需要入驻的是商圈运营主体,并非所有受邀加入商圈的门店或商家。如果多个商圈由同一主体运营,并共用一个企业支付宝账号,通常不必为每个商圈重复入驻。是否需要分别创建应用,则要以支付即积分产品后台和对应接入文档为准。

为什么商圈主体仍需入驻

ISV 与商圈运营主体的职责不同:

  • ISV 开发第三方应用、提供技术服务,并发起商家接入或授权。
  • 商圈运营主体创建并持有商圈应用,确认业务主体和相关协议。
  • 商圈内商家通过邀请、授权等方式加入,不需要自行创建商圈应用。

ISV 的开放平台账号用于确认系统和技术服务的提供方,商圈企业账号则用于确认商圈业务的运营及责任主体,两者不能相互代替。

如果使用商圈企业支付宝账号登录开放平台时看到“请先入驻开放平台”,通常表示当前流程要求该企业先成为开放平台开发者或商家主体。这不代表第三方应用申请失败,也不表示 ISV 资质尚未生效。

推荐接入步骤

建议按以下顺序操作:

  1. ISV 使用自己的企业支付宝账号入驻开放平台。
  2. ISV 创建并配置第三方应用,申请支付即积分所需的能力。
  3. 商圈运营主体使用自己的企业支付宝账号入驻开放平台。
  4. 商圈运营主体通过产品入口选择“商家应用模板”,创建商圈应用。
  5. ISV 从第三方应用侧发起邀请或授权。
  6. 商圈运营主体确认授权,ISV 取得相应的授权凭证。
  7. ISV 使用第三方应用身份和商家授权令牌调用后续接口。
  8. 商圈运营主体继续邀请符合条件的商家加入商圈。

如果后台没有“商家应用模板”入口,或者创建应用时无法选择支付即积分能力,可以依次检查:

  • 当前登录的是否为商圈运营主体的企业支付宝账号;
  • 企业实名认证和开放平台入驻是否已经完成;
  • 当前账号是否具有管理员权限;
  • 第三方应用是否已申请相应的产品能力;
  • 商圈主体的所属行业、签约状态或所在地区是否符合产品开放条件。

授权调用示例

账号入驻和商圈应用创建都需要在开放平台后台完成,没有可替代这些操作的 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、商圈企业账号、页面提示和操作截图,并向支付宝开放平台技术支持确认当前账号适用的接入路径。在确认前不要反复创建应用,以免产生多个无效应用或建立错误的主体关系。

备注:内容仅供参考。