Skip to main content
تُعلمك webhooks الخاصة بالدفعات بموعد انتقال أموالك من Dodo Payments إلى حسابك المصرفي. استخدمها لمطابقة الدفعات في أنظمة المحاسبة لديك دون إجراء polling لنقطة النهاية List Payouts.

أحداث webhook للدفعات

تُصدر الدفعة حدثًا في كل مرحلة من دورة حياتها. وتتطابق المراحل مع حالات الدفعات المعروضة في لوحة التحكم لديك.
كان payout.created يُصدر سابقًا باسم payout.not_initiated. إذا كانت نقطة نهاية موجودة تُجري تصفيةً حسب payout.not_initiated، فحدّث عامل التصفية إلى payout.created ليواصل المطابقة. يظل الحقل status في الحمولة يُبلغ عن not_initiated في هذه المرحلة.

معالجة أحداث الدفعات

تتعلق الدفعات بأموالك الخاصة، لا بأموال العميل، ولذلك تُستخدم هذه الأحداث عادةً في مسك الدفاتر والتنبيهات الداخلية بدلًا من التدفقات التي يواجهها العملاء.
Handling payout events
تحقق دائمًا من توقيع webhook قبل المعالجة — راجع دليل Webhooks لمعرفة الإعداد. يتجاهل المعالج أعلاه التحقق للاختصار.
أحداث الدفعات ليست نهائية ولا مرتبة ترتيبًا صارمًا. قد يصل payout.failed بعد payout.success عندما يعيد أحد البنوك التحويل، وقد يصل payout.success بعد payout.failed عندما تتم استعادة دفعة فاشلة لاحقًا. تعامل مع الحقل status في الحمولة باعتباره الحالة الحالية، بدلًا من افتراض أن آخر حدث تلقيته هو الحدث النهائي.

حالة الدفعة

يعرض كائن الدفعة تقدمه من خلال حقل واحد:
الحقول refunds وchargebacks وtax في الحمولة مهملة. استخدم نقاط نهاية تفصيل الدفعات للحصول على تفصيل شامل بدلًا من ذلك.

ذات صلة

Payout Structure

كيفية جدولة الدفعات واحتسابها، وما الذي تعنيه كل حالة من حالات الدفعات.

Balances & Wallets

تتبّع أرصدة المحفظة ودفتر الأستاذ الذي يقف وراء كل دفعة.

مخطط حمولة webhook

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.

آخر تعديل في ٦ أغسطس ٢٠٢٦