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"
  }
}

Cuándo se dispara

Cuando se completa la liquidación bancaria de una transferencia, el momento en que el dinero efectivamente llega a tu cuenta bancaria, confirmado por el proveedor de pagos. Este es el estado terminal de éxito del ciclo de vida de la transferencia iniciado por payout.created.

paidAt es la hora de llegada confirmada por el proveedor. Se dispara exactamente una vez por transferencia.

Úsalo para conciliar los depósitos bancarios contra las transferencias que los originaron.