Webhook Payloads
打款 Webhooks
当打款创建或状态发生变化时,发送到您的 webhook endpoint 的 payload。使用这些事件在您的会计系统中对账。
打款 webhook 会在您自己的资金从 Dodo Payments 转入您的银行账户时通知您。使用它们在您的会计系统中对账打款,无需轮询 List Payouts endpoint。
打款 Webhook 事件
打款会在其生命周期的每个阶段触发一个事件。这些阶段与您的 dashboard 中显示的 打款状态一致。payout.created 之前以 payout.not_initiated 的形式发送。如果现有 endpoint 按 payout.not_initiated 进行过滤,请将过滤条件更新为 payout.created,以便继续匹配。此阶段,payload 上的 status 字段仍会报告 not_initiated。处理打款事件
打款涉及的是您自己的资金,而不是客户的资金,因此这些事件通常用于记账和内部告警,而不是面向客户的流程。Handling payout events
打款状态
打款对象通过单个字段报告其进度:payload 上的
refunds、chargebacks 和 tax 已弃用。请改用 打款拆分 endpoint 获取详细明细。相关内容
Payout Structure
打款如何安排和计算,以及每种打款状态的含义。
Balances & Wallets
跟踪 wallet 余额以及每笔打款背后的 ledger。
Webhook Payload Schema
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日