com.gigs.voucher.updated

  • Name
    object
    Type
    string
    required
    Description

    Type of object is always event.

  • Name
    id
    Type
    string
    required
    Description

    Unique identifier for the event.

    Example: evt_0SNlurA049MEWV5gNTcQ5A07h3Ol
  • Name
    data
    Type
    object
    required
    Description
    • Name
      object
      Type
      string
      required
      Description

      Type of object is always voucher.

    • Name
      id
      Type
      string
      required
      Description

      Unique identifier for the voucher.

      Example: vou_0SNlurA049MEWV0h2jfjkdiOdplN
    • Name
      name
      Type
      string
      required
      Description

      The voucher's name.

      Example: Monthly Basic 15%
    • Name
      priceDiscount
      Type
      nullable object
      required
      Description
      The price amount of the discount applied via the voucher. A voucher object has always either a priceDiscount or a priceDiscountPercentage.
    • Name
      priceDiscountPercentage
      Type
      nullable number
      required
      Description

      The percentage amount of the discount applied via the voucher. A voucher object has always either a priceDiscount or a priceDiscountPercentage.

      Example: 30.12
      >= 1
      <= 100
    • Name
      recurrence
      Type
      object
      required
      Description
      Details on whether and for how long the discounts applied via the voucher recur.
    • Name
      redemptions
      Type
      integer
      required
      Description

      Number of times the voucher has been redeemed.

      Example: 2
    • Name
      restrictions
      Type
      object
      required
      Description
      Conditions under which the voucher can be used.
    • Name
      retiredReason
      Type
      nullable string
      required
      Description

      Label indicating the reason why the voucher is retired.

      Allowed values: , manualAction, expired, maxRedemptionsReached, unknown
    • Name
      status
      Type
      string
      required
      Description
      Allowed values: available, retired
    • Name
      createdAt
      Type
      string
      required
      Description

      Time when the voucher was created.

      Example: 2021-02-14T19:38:34Z
  • Name
    datacontenttype
    Type
    string
    required
    Description

    The RFC 2046 content-type.

    Example: application/json
    Default: application/json
  • Name
    previousData
    Type
    object
    Description
    Present only for events of type `*.updated`. Contains the values fields in the schema had prior to the update. This field is the result of a shallow diff of the previous schema (i.e., if a nested field has changed, then the entire object will be included).
    • Name
      project
      Type
      string
      required
      Description

      Unique identifier for the project where the event occurred.

      Example: gigs
    • Name
      source
      Type
      string
      required
      Description

      URI identifying the event source.

      Example: https://api.gigs.com
      Default: https://api.gigs.com
    • Name
      specversion
      Type
      string
      required
      Description

      The CloudEvents spec version.

      Example: 1.0
      Default: 1.0
    • Name
      time
      Type
      string
      required
      Description

      Time when the event occurred.

      Example: 2022-03-16T14:12:42Z
    • Name
      type
      Type
      string
      required
      Description

      Type is always com.gigs.voucher.updated.

    • Name
      version
      Type
      string
      required
      Description

      API version used to serialize the data and the event itself.

      Default: 2024-08-29

    Example

    {
      "object": "event",
      "id": "evt_0SNlurA049MEWV5gNTcQ5A07h3Ol",
      "data": {
        "object": "voucher",
        "id": "vou_0SNlurA049MEWV0h2jfjkdiOdplN",
        "name": "Monthly Basic 15%",
        "priceDiscount": {
          "amount": 999,
          "currency": "USD"
        },
        "priceDiscountPercentage": 30.12,
        "recurrence": {
          "type": "once"
        },
        "redemptions": 2,
        "restrictions": {
          "expiresAt": "2021-04-14T19:38:34Z"
        },
        "status": "available",
        "createdAt": "2021-02-14T19:38:34Z"
      },
      "datacontenttype": "application/json",
      "project": "gigs",
      "source": "https://api.gigs.com",
      "specversion": "1.0",
      "time": "2022-03-16T14:12:42Z",
      "type": "com.gigs.voucher.updated",
      "version": "2024-08-29"
    }