WebHook 功能

多会支持为活动设置一个 WebHook 接收地址,当活动有报名出票、退款、销票等事件发生时,我们会主动 POST 订单数据到指定的地址。

请求示例:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
POST /yoururl
Content-Type: application/json

{
"status": "paid", // 订单当前状态 paid 已出票, refunded 已退款, partially_used (多张票时)已销部分票, done 已销全部票。
"order_id": 863, // 订单 ID
"ticket_id": 1053, // 票种 ID
"event_id": 668, // 活动 ID
"custom_fields": [ // 自定义表单
{
"key": "地址",
"value": "1"
},
{
"key": "邮编",
"value": "1"
}
],
"remark": "测试", // 备注
"email": "test@tinyticket.co", // 订单邮箱
"phone": "18673673161", // 订单电话
"user_nickname": null, // 用户昵称
"user_avatar": "https://duohui.co/images/default-avatar.png", // 用户头像
"code": "6688888", // 入场券号
"quantity": 2, // 票数量
"used_quantity": 0, // 已销数量
"refunded_quantity": 0, // 已退款数量
"total_amount": "200.00", // 总价
"paid_amount": "200.00", // 已付金额
"discount_amount": "0.00", // 折扣金额
"refunded_amount": "0.00", // 已退款金额
"created_at": "2017-08-28T10:02:36.000Z", // 订单创建时间
"updated_at": "2017-08-28T10:02:36.000Z", // 订单修改时间
"external": false // 是否为外部订单
}

注意事项:

  • 返回状态码必须为 2xx,例如 200、204 等。
  • 非 2xx 状态码的返回将判定为请求失败,并在后台自动重试若干次。
  • 由于请求可能会重试多次,请用户在处理时防止重复处理