Skip to main content
打款 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
在处理之前,务必验证 webhook 签名 — 有关设置,请参阅 Webhooks guide。为简洁起见,上面的处理程序省略了验证步骤。
打款事件既不是终态事件,也不一定严格按顺序发生。当银行退回转账时,payout.failed 可能会在 payout.success 之后到达;当失败的打款之后恢复时,payout.success 也可能会在 payout.failed 之后到达。应将 payload 上的 status 字段视为当前状态,而不要假设您收到的最后一个事件就是最终状态。

打款状态

打款对象通过单个字段报告其进度:
payload 上的 refundschargebackstax 已弃用。请改用 打款拆分 endpoint 获取详细明细。

相关内容

Payout Structure

打款如何安排和计算,以及每种打款状态的含义。

Balances & Wallets

跟踪 wallet 余额以及每笔打款背后的 ledger。

Webhook Payload Schema

amount
integer<int64>
必填

The total amount of the payout.

business_id
string
必填

The unique identifier of the business associated with the payout.

chargebacks
integer<int64>
必填
已弃用

The total value of chargebacks associated with the payout.

created_at
string<date-time>
必填

The timestamp when the payout was created, in UTC.

currency
enum<string>
必填

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
fee
integer<int64>
必填

The fee charged for processing the payout.

payment_method
string
必填

The payment method used for the payout (e.g., bank transfer, card, etc.).

payout_id
string
必填

The unique identifier of the payout.

refunds
integer<int64>
必填
已弃用

The total value of refunds associated with the payout.

status
enum<string>
必填

The current status of the payout.

可用选项:
not_initiated,
in_progress,
on_hold,
failed,
success
tax
integer<int64>
必填
已弃用

The tax applied to the payout.

updated_at
string<date-time>
必填

The timestamp when the payout was last updated, in UTC.

name
string | null

The name of the payout recipient or purpose.

payout_document_url
string | null

The URL of the document associated with the payout.

remarks
string | null

Any additional remarks or notes associated with the payout.

最后修改于 2026年8月6日