ACH Direct Debit

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

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

Lower Processing Cost

تبلغ تكلفة ACH نسبة ثابتة قدرها 1.5% لكل دفعة، بحد أقصى $15، بدلًا من رسوم البطاقة. راجع الأسعار.

No Card Required

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

Higher Value Orders

نظرًا إلى أن الرسوم محددة بحد أقصى قدره $15، يزداد التوفير مقارنةً برسوم البطاقة مع ارتفاع قيمة الطلب. يناسب ACH عمليات الشراء الكبيرة لمرة واحدة.

نظرة عامة

التفصيل	القيمة
عملة الفوترة	USD
الدول المدعومة	الولايات المتحدة
الاشتراكات	لا
الحد الأدنى للمبلغ	$0.50
التسوية	حتى 4 أيام عمل

لا تتم معالجة ACH Direct Debit بشكل فوري. قد تستغرق الدفعة حتى 4 أيام عمل للنجاح أو الفشل. لا يعني الخصم المصرّح به أن الدفعة تمت تسويتها؛ نفّذ الطلب فقط بعد أن تصل الدفعة إلى حالة النجاح.

آلية العمل

تجربة العميل

يختار العميل ACH Direct Debit عند الدفع.
يُدخل العميل اسم صاحب الحساب، ورقم التوجيه، ورقم الحساب، ونوع الحساب (جارٍ أو توفير)، وعنوان البريد الإلكتروني. يتحقق Checkout من صحة رقم التوجيه.
يرسل العميل النموذج، مما يصرّح بخصم المبلغ من حسابه البنكي في الولايات المتحدة بموجب تفويض.
تُرسل الدفعة إلى شبكة ACH وتدخل في حالة المعالجة. يكتمل Checkout دون انتظار التسوية.
تكتمل التسوية خلال أيام العمل التالية.
تنتقل الدفعة إلى حالة النجاح، أو تفشل إذا أعادها البنك.

نظرًا إلى أن التسوية غير متزامنة، استخدم webhooks لمعرفة النتيجة النهائية بدلًا من إعادة التوجيه من Checkout. لا يعني إعادة التوجيه بعد Checkout سوى أن العميل صرّح بالخصم.تُصدر الدفعة payment.processing بمجرد إرسال الخصم، ثم payment.succeeded أو payment.failed عند اكتمال التسوية. نفّذ الطلب فقط عند payment.succeeded.

التوفر

تظهر ACH Direct Debit عند الدفع عندما تتحقق جميع الشروط التالية:

عملة الفوترة هي USD.
بلد الفوترة هو US.
المعاملة هي دفعة لمرة واحدة.

لا يتوفر ACH Direct Debit للاشتراكات. بالنسبة إلى المدفوعات المتكررة، استخدم البطاقات أو طريقة أخرى تدعم الاشتراكات. راجع نظرة عامة على Payment Methods.

الإعداد

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['ach', 'credit', 'debit'],
  billing_currency: 'USD',
  billing_address: {
    country: 'US',
    zipcode: '94102'
  },
  return_url: 'https://example.com/success'
});

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

نوع طريقة API

النوع	الطريقة	البلد
`ach`	ACH Direct Debit	الولايات المتحدة

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

تستخدم عمليات ردّ الأموال والنزاعات الخاصة بمدفوعات ACH واجهات API وتدفقات لوحة التحكم نفسها المستخدمة مع جميع طرق الدفع الأخرى. لا تحتاج إلى معالجة خاصة بـ ACH.

يمكن لبنك العميل إعادة خصم ACH بعد أن يبدو أنه اكتمل، وبموجب قواعد Nacha يمكن للعميل إعادة خصم غير مصرّح به من حساب شخصي لمدة تصل إلى 60 يومًا تقويميًا بعد التسوية. لا تُصدر ردّ أموال حتى تصل الدفعة الأصلية إلى حالة النجاح.

الاختبار

Enable test mode

عطّل مفتاح Live Mode في الشريط الجانبي للوحة التحكم، واستخدم مفاتيح API التي أُنشئت في وضع الاختبار.

Set currency and billing address

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

Include ach in allowed methods

مرّر ach في allowed_payment_method_types، أو احذف الحقل لإظهار جميع الطرق المؤهلة.

Enter the test bank details

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

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

يُدخل العميل رقمي الحساب والتوجيه في نموذج Checkout. في وضع الاختبار، استخدم رقم التوجيه 110000000 مع أحد أرقام الحسابات التالية لفرض نتيجة:

رقم الحساب	رقم التوجيه	السلوك
`000123456789`	`110000000`	تنجح الدفعة.
`000222222227`	`110000000`	تفشل الدفعة بسبب عدم كفاية الأموال.
`000111111113`	`110000000`	تفشل الدفعة لأن الحساب مغلق.
`000111111116`	`110000000`	تفشل الدفعة بسبب عدم العثور على حساب.
`000333333335`	`110000000`	تفشل الدفعة لأن الخصومات غير مصرّح بها على الحساب.
`000444444440`	`110000000`	تفشل الدفعة بسبب عملة غير صالحة.
`000555555559`	`110000000`	تنجح الدفعة، ثم تؤدي إلى نزاع.
`000000000009`	`110000000`	تظل الدفعة قيد المعالجة إلى أجل غير مسمى. استخدمها لاختبار واجهة المستخدم الخاصة بالحالة المعلّقة.

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

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

Don't fulfill on authorization

تفويض ACH ليس دفعة. انتظر حتى تصل الدفعة إلى حالة النجاح قبل منح الوصول أو شحن الطلب. لا يزال بإمكان بنك العميل إعادة الخصم.

Set customer expectations at checkout

أخبر العملاء بأن المدفوعات البنكية لا تتم تسويتها فورًا. يقلل ذلك من طلبات الدعم التي تستفسر عن سبب استمرار الطلب في حالة معلّقة.

Provide card fallbacks

ضمّن credit وdebit إلى جانب ach، حتى يتمكن العملاء الذين يحتاجون إلى وصول فوري إلى منتجك من اختيار طريقة أسرع.

Use ACH for high-value one-time purchases

تبلغ رسوم ACH حدًا أقصى قدره $15، لذلك يكون التوفير الأكبر في عمليات الشراء الكبيرة لمرة واحدة.

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

ACH not appearing at checkout

تحقق:

هل عملة الفوترة هي USD؟
هل بلد فوترة العميل هو US؟
هل ach مُضمّن في allowed_payment_method_types؟
هل هذه دفعة لمرة واحدة؟ لا يتوفر ACH للاشتراكات.
هل المبلغ لا يقل عن $0.50؟

الحل: أزل allowed_payment_method_types مؤقتًا لرؤية جميع الطرق المؤهلة، ثم تحقّق من عملة الفوترة وبلد العنوان في طلب API.

ACH not appearing on a subscription checkout

السبب: يتوفر ACH Direct Debit للمدفوعات لمرة واحدة فقط.الحل: استخدم البطاقات أو طريقة أخرى تدعم الاشتراكات للفوترة المتكررة.

Payment stuck in processing

السبب: هذا متوقع. تظل دفعة ACH في حالة المعالجة طوال فترة التسوية، وهي أطول بكثير من فترة دفعة البطاقة.الحل: انتظر webhook النهائي. لا تعاود محاولة الدفعة، لأن إعادة المحاولة قد تؤدي إلى خصم المبلغ من العميل مرتين.

Payment failed after initially succeeding at checkout

السبب: اكتمل Checkout، لكن بنك العميل أعاد الخصم أثناء التسوية، وغالبًا بسبب عدم كفاية الأموال أو إغلاق الحساب. تُصدر الدفعة payment.failed.الحل: اعتبر الدفعة فاشلة، واطلب من العميل الدفع باستخدام طريقة أخرى. نفّذ الطلب فقط عند الوصول إلى حالة النجاح لتجنب ذلك.

صفحات ذات صلة

Payment Methods Overview

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

Adaptive Currency

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

Checkout Guide

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

Webhooks

تعامل مع تأكيدات الدفع المؤجلة بشكل غير متزامن.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

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

Lower Processing Cost

No Card Required

Higher Value Orders

نظرة عامة

آلية العمل

تجربة العميل

التوفر

الإعداد

نوع طريقة API

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

الاختبار

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

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

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

صفحات ذات صلة

Payment Methods Overview

Adaptive Currency

Checkout Guide

Webhooks

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

Lower Processing Cost

No Card Required

Higher Value Orders

​نظرة عامة

​آلية العمل

​تجربة العميل

​التوفر

​الإعداد

​نوع طريقة API

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

​الاختبار

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

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

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

​صفحات ذات صلة

Payment Methods Overview

Adaptive Currency

Checkout Guide

Webhooks

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

نظرة عامة

آلية العمل

تجربة العميل

التوفر

الإعداد

نوع طريقة API

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

الاختبار

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

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

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

صفحات ذات صلة