发放红包

请求头

Header	必填	说明
Content-Type	是	application/json
Authorization	是	MD5 签名，算法见签名算法

请求参数

参数	类型	必填	说明
shop_id	string	是	商户编号
account	string	是	收款支付宝账号：手机号 / 邮箱 / 登录号 / UID（2088 开头）
activity_id	string	是	红包活动 ID
timestamp	string	是	当前 Unix 时间戳（秒），建议字符串形式

返回参数

参数	类型	说明
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	贵方配置的异步通知地址，便于核对

失败响应

失败时 code 为 -1，具体原因在 data 中。签名字段必须与 Body 完全一致，否则会返回无效的签名。

常见错误

提示	原因
签名不能为空	缺少 Authorization
无效的签名	shop_id / token 错误，或签名字段与 Body 不一致
数据不完整	缺少必填字段
请填写红包活动ID	activity_id 无效
商户未配置 callback_url	未配置第三方回调地址
无效的支付宝账户	账号过短或格式异常
红包活动不存在或已作废	活动未配置或已停用
红包活动已过有效期	活动过期
红包发放失败 / 具体支付宝错误	支付宝侧拒绝或超时