Violet provides a set of webhooks specifically related to payout account management, enabling you to monitor the lifecycle of merchant payout accounts in your system. These are part of the broader Violet webhook system—if you’re new to how Violet webhooks work, start with our Webhooks Overview for details on managing and testing webhooks.

​
Payout Account Events

​
MERCHANT_PAYOUT_ACCOUNT_CREATED

Emitted when a new Violet Payout Account is created for a merchant. Use this to track when a merchant has completed the first step in enabling payouts through your application.

​
MERCHANT_PAYOUT_ACCOUNT_REQUIREMENTS_UPDATED

Emitted when the KYC or onboarding requirements for a merchant’s payout account are updated. This can happen after account creation, especially when Stripe (or another provider) requests additional information from the merchant.

​
Event Payload

The body of each webhook contains the latest PayoutAccount object, including embedded metadata from the connected payment provider account:

{
  "id": 13618,
  "merchant_id": 15756,
  "app_id": 11106,
  "is_active": true,
  "country_code": "US",
  "payment_provider": "STRIPE",
  "payment_provider_account_id": "acct_1R42bVR9DNmFQUp2",
  "payment_provider_account": {
    "account_id": "acct_1R42bVR9DNmFQUp2",
    "account_type": "EXPRESS",
    "banking_country": "US",
    "banking_currency": "usd",
    "charges_enabled": true,
    "payouts_enabled": true,
    "requirements": {
      "alternatives": [],
      "currently_due": [],
      "errors": [],
      "eventually_due": [],
      "past_due": [],
      "pending_verification": []
    },
    "date_created": "2025-03-18T16:03:01+0000",
    "date_last_modified": "2025-04-05T00:39:53+0000"
  },
  "errors": [],
  "date_created": "2025-03-18T16:03:01+0000",
  "date_last_modified": "2025-04-05T03:19:20+0000"
}

In addition to the JSON payload, the webhook request will include the X-Violet-Entity-External-Id header, which contains the payment provider account ID (e.g., the Stripe account ID like acct_1R42bVR9DNmFQUp2). This can be used to correlate events with your Stripe records.

Was this page helpful?