WebHook 功能

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

请求示例:

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 状态码的返回将判定为请求失败,并在后台自动重试若干次。
  • 由于请求可能会重试多次,请用户在处理时防止重复处理