Skip to main content
تتيح ACH Direct Debit للعملاء في الولايات المتحدة الدفع مباشرةً من حساباتهم المصرفية بدلاً من استخدام بطاقة. وتعمل عبر شبكة Automated Clearing House، وتتوفر في عمليات الدفع بالدولار الأمريكي للمدفوعات لمرة واحدة.

لماذا تقدم ACH Direct Debit؟

Lower Processing Cost

عادةً ما تكون تكلفة معالجة الخصم المصرفي أقل من تكلفة معالجة مدفوعات البطاقات، لا سيما في الطلبات ذات القيمة المرتفعة.

No Card Required

يمكنك الوصول إلى العملاء في الولايات المتحدة الذين يفضلون الدفع من حساب مصرفي أو لا يرغبون في استخدام بطاقة للمشتريات الكبيرة.

Higher Value Orders

تزداد ميزة التكلفة مقارنةً بالبطاقات مع ارتفاع قيمة الطلب، ما يجعل ACH مناسبًا للمشتريات الكبيرة لمرة واحدة.

نظرة عامة

ACH Direct Debit ليست فورية. يستغرق تأكيد الدفع 4 أيام عمل، لذا لا تعتبر التفويض تسويةً — ولا تنفذ الطلب إلا بعد وصول الدفع إلى حالة succeeded.

آلية العمل

تجربة العميل

  1. يختار العميل ACH Direct Debit عند الدفع
  2. يفوض العميل الخصم من حسابه المصرفي في الولايات المتحدة
  3. يُرسل الدفع إلى شبكة ACH ويدخل في حالة processing
  4. تكتمل عملية المقاصة خلال أيام العمل التالية
  5. ينتقل الدفع إلى حالة succeeded، أو يفشل إذا أعاده البنك
نظرًا لأن المقاصة غير متزامنة، اعتمد على webhooks لمعرفة النتيجة النهائية بدلاً من إعادة التوجيه من صفحة الدفع. لا يعني نجاح إعادة التوجيه سوى أن العميل فوّض الخصم.يصدر الدفع payment.processing بعد إرسال الخصم، ثم payment.succeeded أو payment.failed عند اكتمال المقاصة. وحده payment.succeeded آمن لتنفيذ الطلب بناءً عليه.

التوفر

تظهر ACH Direct Debit عند الدفع عندما تتحقق جميع الشروط التالية:
  • عملة الفوترة هي USD
  • بلد الفوترة هو US
  • المعاملة هي دفعة لمرة واحدة
لا تتوفر ACH Direct Debit للاشتراكات. تجعل فترة المقاصة التي تمتد عدة أيام هذه الطريقة غير مناسبة لدورات الفوترة المتكررة. للمدفوعات المتكررة، استخدم البطاقات أو طريقة أخرى تدعم الاشتراكات — راجع نظرة عامة على طرق الدفع.

الإعداد

تتطلب ACH Direct Debit عملة فوترة USD وعنوان فوترة في الولايات المتحدة. إذا كانت أسعارك محددة بعملة أخرى، فعّل Adaptive Currency حتى تتم فوترة العملاء في الولايات المتحدة بالدولار الأمريكي وتصبح ACH متاحة.

نوع طريقة API

المبالغ المستردة والنزاعات

تستخدم المبالغ المستردة والنزاعات الخاصة بمدفوعات ACH واجهات API وتدفقات لوحة التحكم نفسها المستخدمة مع جميع طرق الدفع الأخرى — ولا يلزم تنفيذ معالجة خاصة بـ ACH.
نظرًا إلى إمكانية إعادة مدفوعات ACH من قِبل بنك العميل بعد أن تبدو وكأنها اكتملت، تجنب إصدار المبالغ المستردة حتى يصل الدفع الأصلي إلى حالة succeeded.

الاختبار

1

Enable test mode

استخدم مفاتيح API للاختبار الخاصة بـ Dodo Payments.
2

Set currency and billing address

عيّن عملة الفوترة إلى USD وبلد عنوان الفوترة إلى US.
3

Include `ach` in allowed methods

مرّر ach في allowed_payment_method_types، أو احذف الحقل بالكامل لعرض كل الطرق المؤهلة.
4

Enter the test bank details

أدخل أحد أزواج أرقام التوجيه وأرقام الحسابات للاختبار أدناه، ثم تأكد من أن معالج webhook يتلقى حالة الدفع النهائية.

الحسابات المصرفية للاختبار

يدخل العملاء رقم الحساب ورقم التوجيه مباشرةً عند الدفع. في وضع الاختبار، استخدم رقم التوجيه 110000000 مع أي من أرقام الحسابات أدناه لفرض نتيجة محددة.
تصل معظم مدفوعات الاختبار إلى حالة نهائية أسرع بكثير من فترة المقاصة الفعلية، لذلك لا تحتاج إلى الانتظار أيامًا للتحقق من تكاملك. والاستثناء هو 000000000009، المصمم للبقاء في حالة processing.

أفضل الممارسات

تفويض ACH ليس دفعًا. انتظر حتى يصل الدفع إلى حالة succeeded قبل منح الوصول أو شحن الطلب — إذ لا يزال بإمكان بنك العميل إعادة الخصم.
أبلغ العملاء بأن المدفوعات المصرفية لا تتم مقاصتها فورًا. ويقلل ذلك من تذاكر الدعم التي تسأل عن سبب استمرار الطلب في حالة pending.
احرص دائمًا على تضمين credit وdebit إلى جانب ach حتى يتمكن العملاء الذين يحتاجون إلى وصول فوري إلى منتجك من اختيار طريقة أسرع.
تزداد ميزة تكلفة ACH مع ارتفاع قيمة الطلب، لذا تكون أكثر فائدة في المشتريات الكبيرة لمرة واحدة، لا المشتريات الصغيرة.

استكشاف الأخطاء وإصلاحها

تحقق من:
  1. هل عُيّنت عملة الفوترة إلى USD؟
  2. هل بلد فوترة العميل هو US؟
  3. هل تم تضمين ach في allowed_payment_method_types؟
  4. هل هذه دفعة لمرة واحدة؟ لا تُعرض ACH في الاشتراكات.
الحل: أزل allowed_payment_method_types مؤقتًا لعرض جميع الطرق المؤهلة، ثم تحقق من عملة الفوترة وبلد عنوان الفوترة في طلب API.
السبب: تُعرض ACH Direct Debit للمدفوعات لمرة واحدة فقط.الحل: استخدم البطاقات أو طريقة أخرى تدعم الاشتراكات للفوترة المتكررة.
السبب: هذا متوقع. تظل مدفوعات ACH في حالة processing طوال فترة المقاصة، وهي أطول بكثير من مدفوعات البطاقات.الحل: انتظر webhook النهائي. لا تعاود محاولة الدفع — فقد تؤدي إعادة المحاولة إلى خصم المبلغ من العميل مرتين.
السبب: أعاد بنك العميل الخصم — وغالبًا ما يكون ذلك بسبب عدم كفاية الأموال أو إغلاق الحساب.الحل: تعامل مع الدفع على أنه فاشل واطلب من العميل إعادة المحاولة باستخدام طريقة دفع أخرى. احرص دائمًا على ربط تنفيذ الطلب بحالة succeeded لتجنب ذلك.

صفحات ذات صلة

Payment Methods Overview

اطّلع على جميع طرق الدفع المدعومة.

Adaptive Currency

دعم العملات والتحويل التلقائي.

Checkout Guide

دليل شامل لتنفيذ عملية الدفع.

Webhooks

تعامل مع تأكيدات الدفع المؤجلة بشكل غير متزامن.
آخر تعديل في ١٧ أغسطس ٢٠٢٦