打款
当打款创建或状态发生变化时发送到您的 webhook endpoint 的 payload,以及如何对账每个打款生命周期事件。
打款 Webhook 事件
打款会在其生命周期的每个阶段触发一个事件。这些阶段与您的 dashboard 中显示的 打款状态一致。payout.created 之前以 payout.not_initiated 的形式发送。如果现有 endpoint 按 payout.not_initiated 进行过滤,请将过滤条件更新为 payout.created,以便继续匹配。此阶段,payload 上的 status 字段仍会报告 not_initiated。处理打款事件
打款涉及的是您自己的资金,而不是客户的资金,因此这些事件通常用于记账和内部告警,而不是面向客户的流程。打款状态
打款对象通过单个字段报告其进度:refunds、chargebacks 和 tax 已弃用。请改用 打款拆分 endpoint 获取详细明细。相关内容
Payout Structure
Balances & Wallets
Webhook Payload Schema
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.