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 方式发送

• 为保障推送到达率，系统可能多次进行通知推送，请做好去重逻辑