payout.quote_created

Triggered when the recipient has selected a currency and network and an FX quote has been issued. This is the earliest event you receive for a given external_send_id.

Envelope

Carries the standard event envelope. Payout identifiers: payout_order_uuid, recipient_email, external_send_id (see Payout events → Identifiers).

Event-specific fields

FieldTypeValue
dataHashFull send-request snapshot. See Payout events → data shape.

Example

{
  "event": "payout.quote_created",
  "status": "in_progress",
  "occurred_at": "2026-05-25T10:00:00Z",
  "recipient_email": "[email protected]",
  "external_send_id": "123456",
  "payout_order_uuid": "11111111-2222-3333-4444-555555555555",
  "data": {
    "id": 123456,
    "status": "in_progress",
    "purpose": "Gifq payout to [email protected]",
    "created_at": "2026-05-25T10:00:00.000Z",
    "input_amount": "100.00",
    "input_currency": {
      "id": 33,
      "kind": "crypto",
      "title": "USDC",
      "symbol": "USDC",
      "enabled": true,
      "disabled_message": null
    },
    "sending_amount": "100.00",
    "sending_currency": {
      "id": 33,
      "kind": "crypto",
      "title": "USDC",
      "symbol": "USDC",
      "enabled": true,
      "disabled_message": null
    },
    "input_to_sending_rate": "1.0",
    "balance_debit_amount": "0.047778",
    "balance_debit_currency": {
      "id": 5,
      "kind": "crypto",
      "title": "Ethereum",
      "symbol": "ETH",
      "enabled": true,
      "disabled_message": null
    },
    "sending_to_balance_debit_rate": "2092.89",
    "fees": {
      "service_fee": {
        "amount": "0.00056141",
        "currency": {
          "id": 5,
          "kind": "crypto",
          "title": "Ethereum",
          "symbol": "ETH",
          "enabled": true,
          "disabled_message": null
        }
      },
      "conversion_fee": {
        "amount": "0.000478",
        "currency": {
          "id": 5,
          "kind": "crypto",
          "title": "Ethereum",
          "symbol": "ETH",
          "enabled": true,
          "disabled_message": null
        }
      }
    },
    "ledger_account": {
      "id": "01EXAMPLELEDGER0000000000000",
      "title": "Ethereum main account",
      "status": "active",
      "balance": "10.000000000000000000",
      "account_type": "main",
      "currency": {
        "id": 5,
        "kind": "crypto",
        "title": "Ethereum",
        "symbol": "ETH",
        "enabled": true,
        "disabled_message": null
      }
    },
    "beneficiary_payout_setting": {
      "id": 999,
      "beneficiary_id": 888,
      "created_at": "2026-05-25T09:59:59.000Z",
      "currency": {
        "id": 33,
        "kind": "crypto",
        "title": "USDC",
        "symbol": "USDC",
        "enabled": true,
        "disabled_message": null
      },
      "platform": {
        "id": 21,
        "title": "Solana",
        "id_name": "solana"
      },
      "crypto_address": "ExampleSolanaWalletAddress00000000000000000",
      "crypto_address_metadata": null
    },
    "blockchain_transactions": [],
    "requires_2fa_confirmation": false
  }
}
📘

No duplicates on retry

Idempotent retries of the underlying quote action do not produce duplicate payout.quote_created events for the same external_send_id.

What to do on receipt

  • Treat this as the start of a payout lifecycle keyed by external_send_id, and persist the quote snapshot if you display quote details.
  • Do not assume any funds have moved — status is in_progress at this point.
  • Expect a payout.status_changed and ultimately a payout.terminal_state for this external_send_id.