Webhook 异步通知

搜索文档…

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 方式发送
为保障推送到达率，系统可能多次进行通知推送，请做好去重逻辑

最近更新 1mo ago

复制链接