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
方式发送为保障推送到达率,系统可能多次进行通知推送,请做好去重逻辑
最后更新于
这有帮助吗?