Payload

All webhook payloads follow a consistent top-level structure with event-specific data nested within the data object.

payoutIdstring

The payout ID.

amountnumber

Gross payout amount in cents (100 = $1.00).

feenumber

Provider transfer fee in cents.

netAmountnumber

What reached your bank in cents (amount minus fee).

currencystring

The payout currency. Always "usd".

statusstring

Always "paid" for this event.

destinationBankobject | null

Destination bank display metadata: bankName and last4.

paidAtstring | null

ISO 8601 datetime when the provider confirmed the deposit arrived.

{
  "event": "payout.paid",
  "timestamp": "2026-06-14T09:00:00.000Z",
  "organizationId": "org_abc123",
  "mode": "live",
  "apiVersion": "2026-06-10",
  "data": {
    "payoutId": "8b6f2a1c-4d3e-4f5a-9b8c-7d6e5f4a3b2c",
    "amount": 20000,
    "fee": 0,
    "netAmount": 20000,
    "currency": "usd",
    "status": "paid",
    "destinationBank": {
      "bankName": "CHASE",
      "last4": "6789"
    },
    "paidAt": "2026-06-14T09:00:00.000Z"
  }
}

When this fires

When the bank settlement of a payout completes — the moment the money actually reaches your bank account, confirmed by the payment provider. This is the terminal success state of the payout lifecycle started by payout.created.

paidAt is the provider-confirmed arrival time. Fires exactly once per payout.

Use it to reconcile bank deposits against the payouts that produced them.