---
title: "Gift Purchase"
method: POST
path: "GIFT_PURCHASE"
tags: ["Order Events"]
---

# Gift Purchase

`POST GIFT_PURCHASE` (webhook)

Fired when a gift card is purchased.

## Payload

- object
  - `id` string, required — Unique identifier for this webhook event
  - `webhookId` string, required — ID of the webhook configuration that triggered this event
  - `shopId` string, required — ID of the shop that generated this event
  - `type` string, required — The event type
  - `apiVersion` string, required — API version of the webhook payload
  - `createdAt` string, date-time, required — When this event was created
  - `testMode` boolean, required — Whether this event was sent in test mode
  - `data` ComFourthwallOpenapiModelGiftPurchaseV1, required
    - `id` string, required
    - `friendlyId` string, required
    - `shopId` string, required
    - `offer` ComFourthwallOpenapiModelOfferAbstractV1OfferGiftPurchaseV1, required
      - `id` string, required
      - `name` string, required
      - `slug` string, required
      - `description` string, required
      - `primaryImage` ComFourthwallOpenapiModelImage
        - `id` string, required
        - `url` string, required
        - `width` integer, required — The original width of the image in pixels.
        - `height` integer, required — The original height of the image in pixels.
        - `transformedUrl` string, required — Transformed URL with applied image processing (e.g., resizing, optimization)
    - `amounts` ComFourthwallOpenapiModelGiftPurchaseV1Amounts, required
      - `subtotal` Money, required
        - `value` number, required
        - `currency` string, required
      - `tax` Money, required
        - `value` number, required
        - `currency` string, required
      - `total` Money, required
        - `value` number, required
        - `currency` string, required
      - `profit` Money, required
        - `value` number, required
        - `currency` string, required
      - `prepaidShipping` Money, required
        - `value` number, required
        - `currency` string, required
    - `email` string, required
    - `username` string
    - `message` string
    - `quantity` integer, required
    - `gifts` union[], required
      - union
        - ComFourthwallOpenapiModelGiftPurchaseV1GiftAvailable
          - `status` 'AVAILABLE', required
          - `id` string, required
          - `winner` ComFourthwallOpenapiModelGiftPurchaseV1Winner
            - `email` string
            - `username` string
            - `selectedAt` string, date-time, required
        - ComFourthwallOpenapiModelGiftPurchaseV1GiftCancelled
          - `status` 'CANCELLED', required
          - `id` string, required
          - `winner` ComFourthwallOpenapiModelGiftPurchaseV1Winner
            - `email` string
            - `username` string
            - `selectedAt` string, date-time, required
        - ComFourthwallOpenapiModelGiftPurchaseV1GiftChangedToPromotion
          - `status` 'CHANGED_TO_PROMOTION', required
          - `id` string, required
          - `promotionId` string, required
          - `winner` ComFourthwallOpenapiModelGiftPurchaseV1Winner, required
            - `email` string
            - `username` string
            - `selectedAt` string, date-time, required
        - ComFourthwallOpenapiModelGiftPurchaseV1GiftRedeemed
          - `status` 'REDEEMED', required
          - `id` string, required
          - `orderId` string, required
          - `orderFriendlyId` string, required
          - `winner` ComFourthwallOpenapiModelGiftPurchaseV1Winner, required
            - `email` string
            - `username` string
            - `selectedAt` string, date-time, required
    - `createdAt` string, date-time, required

## Acknowledgement `200`

Event received successfully

---

[API](https://skmtc.net/fourthwall/apis/fourthwall-apis-2.md) · [All operations](https://skmtc.net/fourthwall/apis/fourthwall-apis-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fourthwall/fourthwall-apis-2/revisions/ef273312f051/schema)