支付宝立减金功能的相关文档在哪里？

2026-10-24支付阿杰

结论

支付宝支持“支付时直接抵扣”的营销方式，但“立减金”通常只是业务名称或活动页面上的展示名称，不一定对应一个向所有开发者开放、正式名称为“立减金”的标准 API 产品。

如果在支付宝开放平台只能查到“商家券”“支付券”，却找不到单独的立减金接入文档，可能有以下几种原因：

这项能力由支付宝配置和发放，商家无法通过通用 API 自行创建。
该能力只向特定行业、商家等级或合作项目开放，账号获得权限并登录后才能查看完整文档。
实际需要接入的是支付券、商家券、红包、支付营销或资金营销中的某项能力，只是在用户端统一显示为“立减金”。
网上流传的案例来自特定时期或定向合作项目，现在可能已经更名，或者不再以相同方式开放。

所以，不能只凭“立减金”这个展示名称判断接入方式，也不应套用来源不明的接口名称。

先确认具体需求

咨询支付宝之前，先明确立减金的业务规则：

优惠资金由商家承担，还是由支付宝承担？
用户是否需要提前领取？
优惠是否只能在指定商家使用？
优惠形式是满减、随机减，还是固定金额抵扣？
优惠是在支付下单前计算，还是由支付宝收银台自动核销？
是否需要通过 API 向指定用户发放？
退款时是否需要同步退回优惠资格或资金？

这些条件会影响最终选择商家券、支付券、红包类产品，还是申请定向营销能力。需要特别注意的是，“无需领券、付款时自动减”描述的是一种核销体验，并不表示后台一定存在名为“立减金”的开放接口。

文档和权限在哪里查

可以按下面的路径排查。

1. 在支付宝开放平台搜索业务关键词

登录支付宝开放平台后，在文档中心分别搜索：

立减
支付券
商家券
红包
营销
优惠
资金营销

有些产品文档只有在账号具备相应权限后才会完整显示，因此需要在登录状态下查询。

2. 检查应用可添加的产品能力

进入对应应用的产品绑定或能力管理页面，检查是否有营销、券、红包等相关产品。如果无法添加产品，常见原因包括：

应用类型不符合要求；
商家主体或所属行业不在开放范围内；
尚未签约对应产品；
产品采用邀请制或定向开放；
当前应用没有相应权限。

在公开文档中搜不到接口，不代表这项能力一定不存在。但如果控制台中也没有产品入口，通常无法由商家直接自行接入。

3. 通过官方渠道确认产品映射

联系支付宝开放平台技术支持、商家客服或对应业务经理时，不要只问“有没有立减金”，而应说明完整的使用场景，例如：

商家承担优惠资金，希望向指定用户发放固定金额权益。用户不需要主动领券，在指定商家付款时由支付宝收银台自动抵扣。请确认该场景对应的开放产品名称、申请条件、产品文档和 API 权限。

还需要确认以下信息：

正式产品名称；
是否公开开放；
申请条件和签约入口；
是否支持向指定用户发放；
发放、查询、核销和退款分别使用哪些 API；
优惠资金如何结算；
沙箱环境是否支持。

支付宝官方确认产品名称和权限范围后，才能继续确定具体接口。

接入时如何验证优惠结果

如果立减活动由支付宝收银台执行，商户下单时不一定需要额外传入“立减金额”参数。支付完成后，可以通过支付查询接口核对订单金额、买家实付金额和优惠金额。

下面的示例仅用于查询支付结果，不能用于创建或发放立减金：

AlipayClient alipayClient = new DefaultAlipayClient(
    gatewayUrl,
    appId,
    merchantPrivateKey,
    "json",
    "UTF-8",
    alipayPublicKey,
    "RSA2"
);

AlipayTradeQueryRequest request = new AlipayTradeQueryRequest();
request.setBizContent("""
{
  "out_trade_no": "ORDER_202609090001"
}
""");

AlipayTradeQueryResponse response = alipayClient.execute(request);

if (response.isSuccess()) {
    System.out.println("trade_no: " + response.getTradeNo());
    System.out.println("total_amount: " + response.getTotalAmount());
    System.out.println("buyer_pay_amount: " + response.getBuyerPayAmount());
    System.out.println("discount_amount: " + response.getDiscountAmount());
} else {
    System.err.println("code: " + response.getCode());
    System.err.println("sub_code: " + response.getSubCode());
    System.err.println("sub_msg: " + response.getSubMsg());
}

实际返回字段应以支付宝开放平台中 alipay.trade.query 的当前正式文档和所用 SDK 版本为准。支付产品、营销活动或账号权限不同，优惠信息的返回方式也可能不同。

注意事项

不要自行设置“立减金额”并直接从订单金额中扣减。支付订单金额、优惠承担方和结算金额都必须符合支付宝对应产品的规则。
不能只根据页面名称判断商家券、支付券和所谓的立减金是否属于同一种产品。需要比较领取方式、适用范围、核销时机、出资方和退款规则。
网上流传的接口名、产品截图或历史活动页面可能已经调整，也可能只对合作商家开放。
在取得正式产品权限和文档之前，不要根据非官方示例开发发放接口。
支付成功后，应以支付宝异步通知和主动查询结果为准，并校验 app_id、商户订单号、支付金额和交易状态。
优惠金额不一定等于商家承担的金额。如果涉及支付宝出资、商家出资或双方联合出资，应以账单和结算字段为准。

如果支付宝官方确认该场景属于定向营销能力，相关说明和 API 文档通常会在完成签约、加白或权限开通后提供，不会作为普通公共产品文档直接展示。