Webhook 异步通知

开发核心

控制台 设置好 webhook URL 后,面包多会在以下情况下向该 URL 发送请求:

  • 订单支付成功

  • 有订单被投诉

接收 Webhook 通知的URL必须可直接访问,不能携带参数,或其他验证,否则可能会导致请求无法正常完成

请注意 :webhook 的请求方式为 Post Json,不是 form 形式

请求参数

参数名

类型

说明

type

string

通知类型,支付成功为 charge_succeeded,订单投诉为 complaint

data

object

数据包

typecharge_succeeded 时,data 结构如下:

参数名

类型

说明

description

string

商品描述

out_trade_no

string

订单号

amount

int

金额,单位为分

openid

string

支付者 openid (仅微信支付)

charge_id

string

支付渠道流水号

payway

int

支付渠道,微信支付为 1 ,支付宝支付为 2

typecomplaint 时,data 结构如下:

参数名

类型

说明

out_trade_no

string

订单号

complaint_detail

string

投诉详情

amount

int

订单金额,单位为分

payer_phone

string

投诉者电话

⚠️ 注意

  • 异步通知以 post json 方式发送

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