Webhook Payloads
Payout Webhooks
Payout이 생성되거나 상태가 변경될 때 webhook endpoint로 전송되는 payload입니다. 이러한 이벤트를 사용하여 회계 시스템에서 Payout을 조정하세요.
Payout webhook은 자체 자금이 Dodo Payments에서 은행 계좌로 이동할 때 이를 알려줍니다. List Payouts endpoint를 polling하지 않고 회계 시스템에서 지급을 조정하려면 이를 사용하세요.
지급 Webhook 이벤트
지급은 lifecycle의 각 단계에서 이벤트를 발생시킵니다. 각 단계는 dashboard에 표시되는 지급 상태와 일치합니다.payout.created은 이전에 payout.not_initiated로 발생했습니다. 기존 endpoint가 payout.not_initiated를 기준으로 필터링하는 경우, 계속 일치하도록 필터를 payout.created로 업데이트하세요. payload의 status 필드는 이 단계에서도 여전히 not_initiated을 보고합니다.지급 이벤트 처리
지급은 고객의 자금이 아니라 자체 자금과 관련되므로, 이러한 이벤트는 일반적으로 고객에게 표시되는 flow보다는 장부 기록과 내부 alerting에 사용됩니다.Handling payout events
지급 상태
지급 object는 단일 필드를 통해 진행 상태를 보고합니다:payload의
refunds, chargebacks 및 tax은 deprecated되었습니다. 대신 자세한 내역은 payout breakup endpoints를 사용하세요.관련 문서
Payout Structure
지급이 예약되고 계산되는 방식과 각 지급 상태의 의미를 설명합니다.
Balances & Wallets
wallet 잔액과 각 지급을 뒷받침하는 ledger를 추적합니다.
Webhook Payload 스키마
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 마지막 수정일 2026년 9월 26일