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 reaches your bank in cents (amount minus fee).

currencystring

The payout currency. Always "usd".

statusstring

The payout status. "pending" at creation.

destinationBankobject | null

Destination bank display metadata: bankName and last4. Full account numbers never appear in webhook payloads.

createdAtstring

ISO 8601 datetime when the payout was created.

{
  "event": "payout.created",
  "timestamp": "2026-06-12T10: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": "pending",
    "destinationBank": {
      "bankName": "CHASE",
      "last4": "6789"
    },
    "createdAt": "2026-06-12T10:00:00.000Z"
  }
}

Cuándo se dispara

Cuando se solicita una transferencia de tu saldo disponible y se inicia el envío hacia tu banco. La transferencia comienza en pending y avanza desde ahí por las etapas de envío y liquidación bancaria.

destinationBank lleva solo metadatos de visualización (nombre del banco y last4); los números de cuenta completos nunca aparecen en los payloads de webhook.

El ciclo de vida continúa con payout.paid cuando el dinero llega, o payout.failed si el banco lo rechaza.