Webhook 异步通知
开发核心
在
控制台 设置好 webhook URL 后，面包多会在以下情况下向该 URL 发送请求：- 订单支付成功
- 有订单被投诉
接收 Webhook 通知的 URL 必须可直接访问，不能携带参数，或其他验证，否则可能会导致请求无法正常完成
请注意 ：webhook 的请求方式为 Post Json，不是 form 形式
请求参数
| | |
参数名 | 类型 | 说明 |
type | string | 通知类型，支付成功为 charge_succeeded，订单投诉为 complaint |
data | object | 数据包 |
当
type 为 charge_succeeded 时，data 结构如下： | | |
参数名 | 类型 | 说明 |
description | string | 商品描述 |
out_trade_no | string | 订单号 |
amount | int | 金额，单位为分 |
openid | string | 支付者 openid (仅微信支付) |
charge_id | string | 支付渠道流水号 |
payway | int | 支付渠道，微信支付为 1 ，支付宝支付为 2 |
当
type 为 complaint 时，data 结构如下： | | |
参数名 | 类型 | 说明 |
out_trade_no | string | 订单号 |
complaint_detail | string | 投诉详情 |
amount | int | 订单金额，单位为分 |
payer_phone | string | 投诉者电话 |
⚠️ 注意
- 异步通知以
post json方式发送 - 为保障推送到达率，系统可能多次进行通知推送，请做好去重逻辑
最近更新 3mo ago