DonationCreatedResponse

A donation as returned by the public create endpoints, merged with checkout meta. Narrower than DonationResponse: the handler serializes a row it just created rather than one it read back, so asset and payment are never present, designation is the only relation returned, and no foreign key fields are serialized. Fields below are always present; nullable ones are returned as null rather than omitted.

  • created_at
    Type: string Format: date-time
    required

    the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

  • donor_email
    Type: string
    required
  • donor_first_name
    Type: string
    required
  • donor_last_name
    Type: string
    required
  • id
    Type: string
    required

    Donation uuid.

  • identifier
    Type: string
    required

    Currency code, ticker symbol, or coin symbol depending on type.

  • is_recurring
    Type: boolean
    required

    True when the donation belongs to a subscription.

  • meta
    Type: object · DonationCheckoutMeta
    required

    Server-provided fields to finish checkout on a public giving page. Varies by donation type (e.g. Stripe for currency, wallet address for crypto, DTC instructions for stock).

    • dtc
      Type: object | null

      Brokerage / DTC transfer details for stock gifts when applicable.

    • stripe_account
      Type: string | null

      Stripe Connect account id for the organization.

    • stripe_secret
      Type: string | null

      Stripe PaymentIntent or Setup client secret when applicable.

    • wallet_address
      Type: string | null

      Crypto deposit address when applicable.

    • propertyName
      Type: anything
  • quantity
    Type: number
    required

    Amount for currency donations, share or coin count otherwise.

  • recognition
    Type: string enum
    required
    values
    • public
    • private
    • anonymous
  • status
    Type: string enum
    required
    values
    • pledged
    • pending
    • processing
    • complete
    • failed
    • canceled
  • type
    Type: string enum
    required
    values
    • currency
    • stock
    • crypto
    • daf
  • updated_at
    Type: string Format: date-time
    required

    the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

  • cancelation_reason
    Type: string | null enum
    values
    • duplicate
    • donor_cancel
    • other
  • designation
    Type: object · CampaignDesignationResponsenullable

    Null when the donor picked no designation, or the campaign has none.

    • created_at
      Type: string Format: date-time

      the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

    • id
      Type: string
    • name
      Type: string
    • priority
      Type: number
    • updated_at
      Type: string Format: date-time

      the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

  • donor_address_line_1
    Type: string | null
  • donor_address_line_2
    Type: string | null
  • donor_city
    Type: string | null
  • donor_confirmed_at
    Type: string | null Format: date-time

    the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

  • donor_country
    Type: string | null

    Two-letter ISO country code.

  • donor_postal_code
    Type: string | null
  • donor_province
    Type: string | null
  • donor_reported_transfer_date
    Type: string | null Format: date

    full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21

  • memo
    Type: string | null
  • source
    Type: string | null

    Stripe PaymentIntent id, crypto wallet address, or the donor's brokerage for stock.

  • tax_deductible_amount
    Type: number | null

    Set on create for currency donations only; null for stock, crypto and DAF until valued.