支付宝红包业务所需仅 3 个接口：配置（面额 / 满减 / 有效期）、下发（支付宝账号 / 手机号 / UID）、查询（下发中 / 已下发 / 下发失败 / 已核销）。红包显示在用户卡包，收银台自动立减。
这是惠券通上接入最轻量的业务形态，1 天即可完成联调。
所需信息包含：面额、满减门槛、有效期、发放时间、使用场景等。配置成功后返回组合码（redemption_code）。
POST /api/alipay/voucher/setting通过配置接口返回的组合码下发。可根据支付宝账号（logon_id）/ 手机号（phone_id）/ UID 可配参数下发。
POST /api/alipay/voucher/distribute状态包括：下发中 / 已下发 / 下发失败 / 已核销。支持主动查询与核销回调两种方式。
POST /api/alipay/voucher/query不论您手里是账号、手机号还是 UID，都可以选合适的方式下发。
最直观的方式，用户的支付宝登录账号（手机号 / 邮箱），适合有会员体系的商家。
使用用户手机号匹配支付宝账号下发，适合短信营销、线下门店核销场景。
使用支付宝 UID（open_id）下发，适合已通过支付宝小程序/开放平台授权登录的场景。
对比银行立减金，不限卡、不限银行，适用场景最广。
核销、退款、过期事件 V_USE / V_REFUND / V_EXPIRE 全量推送。
一次批次可配置多种面额组合，单券限领数可控。
支持定向至指定商户 PID / store_id，精准锁定使用范围。
每日定时生成核销账单，可下载 CSV 进行对账。
支持库存动态释放，活动期间可灵活追加。
// 1. 配置接口 POST /api/alipay/voucher/setting { "params": { "tax_location_id": 5, "effective_time": "2026-04-24 00:00:00|2026-12-31 23:59:59", "grant_time": "2026-04-24 00:00:00|2026-12-31 23:59:59", "combination_list": [ { "denomination": 20, "sheet": 10000, "transaction_minimum": 100, "number_of_claims": 1 } ], "notify_url": "https://your.com/notify" } } // 2. 下发接口 POST /api/alipay/voucher/distribute { "params": { "log_group_redemption_code": "a-123-uid-1", "account": "138****8888", "account_type": 1 // 1=账号 2=手机号 3=UID } }