Payout
El payload que se envía a tu endpoint de webhook cuando se crea un payout o cambia su estado, y cómo conciliar cada evento del ciclo de vida del payout.
Eventos de webhook de payout
Un payout emite un evento en cada etapa de su ciclo de vida. Las etapas coinciden con los estados de payout que se muestran en tu dashboard.payout.created se emitía anteriormente como payout.not_initiated. Si un endpoint existente filtra por payout.not_initiated, actualiza el filtro a payout.created para que siga coincidiendo. El campo status del payload sigue indicando not_initiated en esta etapa.Gestión de eventos de payout
Los payouts corresponden a tu propio dinero, no al de un cliente, por lo que estos eventos normalmente alimentan la contabilidad y las alertas internas, en lugar de los flujos orientados al cliente.Estado del payout
El objeto payout informa de su progreso mediante un único campo:refunds, chargebacks e tax del payload están obsoletos. Usa los endpoints de desglose de payouts para obtener un desglose detallado.Relacionado
Payout Structure
Balances & Wallets
Esquema del payload del webhook
The total amount of the payout.
The unique identifier of the business associated with the payout.
The total value of chargebacks associated with the payout.
The timestamp when the payout was created, in UTC.
The currency of the payout, represented as an ISO 4217 currency code.
AED, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BWP, BYN, BZD, CAD, CHF, CLP, CNY, COP, CRC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, JMD, JOD, JPY, KES, KGS, KHR, KMF, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRU, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SEK, SGD, SHP, SLE, SLL, SOS, SRD, SSP, STN, SVC, SZL, THB, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VES, VND, VUV, WST, XAF, XCD, XOF, XPF, YER, ZAR, ZMW The fee charged for processing the payout.
The payment method used for the payout (e.g., bank transfer, card, etc.).
The unique identifier of the payout.
The total value of refunds associated with the payout.
The current status of the payout.
not_initiated, in_progress, on_hold, failed, success The tax applied to the payout.
The timestamp when the payout was last updated, in UTC.
The name of the payout recipient or purpose.
The URL of the document associated with the payout.
Any additional remarks or notes associated with the payout.