接入指南
第三方接入人人红包开放接口，向指定支付宝账号发放红包，并接收异步状态回调。发放接口同步返回红包 ID 与金额；支付宝 UID、核销、退款等状态通过异步回调通知。
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
code |
int | 0 成功，-1 失败 |
success |
bool | 接口是否已处理，失败时也可能为 true |
message |
string | success 或 fail |
data |
object / string | 成功时为业务对象，失败时为错误原因 |
data.account |
string | 请求中的收款账号 |
data.voucher_id |
string | 支付宝红包 ID |
data.amount |
number | 实际发放金额（元） |
data.activity_id |
string | 活动 ID |
data.callback_url |
string | 贵方配置的异步通知地址，便于核对 |
正式环境
接口根地址为 https://renrenhongbao.com 。业务接口使用 POST，Content-Type 为 application/json。请先向平台申请商户编号、签名密钥、活动 ID，并配置可公网访问的 HTTPS 回调地址。
接入配置
平台会分配 shop_id 与 token。token 是签名密钥，请妥善保管，不要写在前端或公开仓库。callback_url 是贵方接收异步通知的地址。activity_id 是可用的红包活动 ID。
整体流程
平台先调用支付宝发放，再收齐支付宝通知并落库，最后按 shop_id 转发到贵方 callback_url。
第三方系统
│
│ ① POST 发放请求（带签名）
▼
人人红包 OpenAPI
│
│ ② 调用支付宝发放
▼
支付宝
│
│ ③ 异步通知 → 平台统一回调入口
▼
人人红包（落库：红包状态 / 支付宝 UID 等）
│
│ ④ 按 shop_id 二次转发
▼
第三方 callback_url
要点
发放接口为同步返回。支付宝 UID、核销、退款等状态以异步回调为准。刚发放成功时本地可能暂时没有 user_id。
- 发放接口同步返回 voucher_id 与金额。
- 平台先保存回调，再转发到贵方 callback_url。
- 贵方接口请尽快返回 HTTP 200，正文建议返回 success。
接入前准备
| 配置项 | 说明 |
|---|---|
shop_id | 商户编号 |
token | 签名密钥，请妥善保管 |
callback_url | 贵方接收异步通知的 HTTPS 地址 |
activity_id | 可用的红包活动 ID，由平台分配 |