지급
지급이 생성되거나 상태가 변경될 때 webhook endpoint로 전송되는 payload와 각 지급 lifecycle 이벤트를 조정하는 방법입니다.
지급 Webhook 이벤트
지급은 lifecycle의 각 단계에서 이벤트를 발생시킵니다. 각 단계는 dashboard에 표시되는 지급 상태와 일치합니다.payout.created은 이전에 payout.not_initiated로 발생했습니다. 기존 endpoint가 payout.not_initiated를 기준으로 필터링하는 경우, 계속 일치하도록 필터를 payout.created로 업데이트하세요. payload의 status 필드는 이 단계에서도 여전히 not_initiated을 보고합니다.지급 이벤트 처리
지급은 고객의 자금이 아니라 자체 자금과 관련되므로, 이러한 이벤트는 일반적으로 고객에게 표시되는 flow보다는 장부 기록과 내부 alerting에 사용됩니다.지급 상태
지급 object는 단일 필드를 통해 진행 상태를 보고합니다:refunds, chargebacks 및 tax은 deprecated되었습니다. 대신 자세한 내역은 payout breakup endpoints를 사용하세요.관련 문서
Payout Structure
Balances & Wallets
Webhook Payload 스키마
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.