---
title: "Donation"
method: POST
path: "donation"
tags: ["Order Events"]
---

# Donation

`POST donation` (webhook)

Fired when a new donation is received.

## 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` ComFourthwallOpenapiModelDonationV1, required
    - `id` string
    - `shopId` string
    - `status` 'OPEN' | 'COMPLETED' | 'ABANDONED' | 'CANCELLED' | 'FAILED'
    - `email` string
    - `username` string
    - `message` string
    - `amounts` ComFourthwallOpenapiModelGiftPurchaseV1Amounts
      - `subtotal` ComFourthwallSupportMoneyMoney
        - `currency` 'USD' | 'EUR' | 'CAD' | 'GBP' | 'AUD' | 'NZD' | 'SEK' | 'NOK' | 'DKK' | 'PLN' | 'INR' | 'JPY' | 'MYR' | 'SGD' | 'MXN' | 'BRL' | 'CHF'
        - `zero` boolean
        - `negative` boolean
        - `moreThanZero` boolean
        - `lessThanZero` boolean
        - `zeroOrLess` boolean
        - `currencyScale` integer
      - `tax` ComFourthwallSupportMoneyMoney
        - `currency` 'USD' | 'EUR' | 'CAD' | 'GBP' | 'AUD' | 'NZD' | 'SEK' | 'NOK' | 'DKK' | 'PLN' | 'INR' | 'JPY' | 'MYR' | 'SGD' | 'MXN' | 'BRL' | 'CHF'
        - `zero` boolean
        - `negative` boolean
        - `moreThanZero` boolean
        - `lessThanZero` boolean
        - `zeroOrLess` boolean
        - `currencyScale` integer
      - `total` ComFourthwallSupportMoneyMoney
        - `currency` 'USD' | 'EUR' | 'CAD' | 'GBP' | 'AUD' | 'NZD' | 'SEK' | 'NOK' | 'DKK' | 'PLN' | 'INR' | 'JPY' | 'MYR' | 'SGD' | 'MXN' | 'BRL' | 'CHF'
        - `zero` boolean
        - `negative` boolean
        - `moreThanZero` boolean
        - `lessThanZero` boolean
        - `zeroOrLess` boolean
        - `currencyScale` integer
      - `profit` ComFourthwallSupportMoneyMoney
        - `currency` 'USD' | 'EUR' | 'CAD' | 'GBP' | 'AUD' | 'NZD' | 'SEK' | 'NOK' | 'DKK' | 'PLN' | 'INR' | 'JPY' | 'MYR' | 'SGD' | 'MXN' | 'BRL' | 'CHF'
        - `zero` boolean
        - `negative` boolean
        - `moreThanZero` boolean
        - `lessThanZero` boolean
        - `zeroOrLess` boolean
        - `currencyScale` integer
      - `prepaidShipping` ComFourthwallSupportMoneyMoney
        - `currency` 'USD' | 'EUR' | 'CAD' | 'GBP' | 'AUD' | 'NZD' | 'SEK' | 'NOK' | 'DKK' | 'PLN' | 'INR' | 'JPY' | 'MYR' | 'SGD' | 'MXN' | 'BRL' | 'CHF'
        - `zero` boolean
        - `negative` boolean
        - `moreThanZero` boolean
        - `lessThanZero` boolean
        - `zeroOrLess` boolean
        - `currencyScale` integer
    - `createdAt` string, date-time
    - `updatedAt` string, date-time

## Acknowledgement `200`

Event received successfully

---

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