Skip to main content
Bring Your Own Processor (BYOP) يربط حسابك الخاص على Stripe أو Adyen بـ Dodo Payments. تُعالَج المدفوعات من البلدان التي تختارها عبر حسابك لدى معالج الدفع، بينما يدير Dodo Payments كل ما يحيط بالمعاملة: المنتجات، والاشتراكات، ومفاتيح التراخيص ومحرك الاستحقاقات، والفوترة، وCustomer Portal، والتحليلات. لكل بلد يخص العميل، تختار الجهة التي تعالج الدفع: معالج الدفع الخاص بك، والذي يجعلك البائع القانوني لذلك المسار، أو Dodo Payments بصفته Merchant of Record متكامل الخدمات. تذهب المدفوعات من البلدان التي لا يوجد لها مسار إلى Dodo Payments.

Route by Geography

أرسل المدفوعات من بلدان محددة إلى معالج الدفع الخاص بك، وأرسل كل ما عدا ذلك إلى Dodo Payments.

Keep Your Processor Accounts

واصل استخدام حساباتك وعلاقاتك الحالية مع Stripe أو Adyen.

Stay the Merchant of Record

في مساراتك الخاصة، تظل البائع القانوني وتتحكم في الضرائب والنزاعات وعمليات الدفع.

One Billing Layer

يدير Dodo Payments المنتجات والاشتراكات والفواتير والتحليلات عبر كلا المسارين.

​
BYOP مقابل Dodo كتاجر مسجل

يعمل النموذجان جنبًا إلى جنب. تتبع كل دفعة المسار المحدد لبلد العميل. لعرض هذه المقارنة في لوحة المعلومات، اختر Show Comparison ضمن Settings → BYOP.
الإعداد الشائع هو الهجين: وجّه بلدًا لديك فيه كيان مسجّل ومعالج دفع بالفعل (مثل سوقك المحلي) إلى معالج الدفع الخاص بك، ودع Dodo Payments يتولى بقية العالم بصفته Merchant of Record.

​
معالجات الدفع المدعومة

يمكنك ربط Stripe وAdyen.

Stripe

Adyen

تدعم المدفوعات التي يتم توجيهها عبر معالج الدفع الخاص بك بطاقات الائتمان والخصم فقط.
يتطلب كل من Stripe وAdyen raw card API access في حسابك، حتى يتمكن Dodo Payments من تشغيل الفوترة فوق معالج الدفع الخاص بك. يفعّل كل معالج هذه الميزة عند الطلب، لذا تواصل مع دعم المعالج قبل الربط. تعرض خطوة الاتصال في معالج الإعداد المتطلب نفسه، مع رابط View documentation إلى دليلي Stripe وAdyen.

​
إعداد BYOP

لبدء معالج الإعداد، افتح Settings → BYOP في لوحة المعلومات واختر Configure في بطاقة Bring Your Own Processor.
يتم إعداد الاتصالات لكل بيئة على حدة. يختلف معالج الدفع الذي تربطه في وضع الاختبار (المعروض باسم Sandbox) عن المعالج الذي تربطه في الوضع المباشر (المعروض باسم Production). لاختبار الإعداد قبل بدء العمل، أعد إعداد كليهما. يستخدم معالج الإعداد الوضع المحدد بواسطة مفتاح Live Mode في الشريط الجانبي.
إعدادات BYOP تعرض خيار التاجر المسجل وخيار استخدام معالجك الخاص مع مقارنة الميزات
1

Choose a Payment Processor

في Select Payment Processor، اختر Stripe أو Adyen، ثم اختر Continue.
حوار اختيار معالج الدفع مع خيارات Stripe و Adyen
2

Connect Your Account

أدخل تفاصيل الاتصال، ثم اختر Connect processor:
  • Processor Name: اسم لهذا الاتصال، يتراوح طوله بين حرفين و75 حرفًا. يفيد الاسم عند ربط عدة حسابات من معالج واحد، مثل Stripe US وStripe UK.
  • Secret Key: مفتاح API الخاص بمعالج الدفع للوضع الحالي. بالنسبة إلى Stripe، هذا هو مفتاح sk_... السري.
  • Merchant Account (لـ Adyen فقط): معرّف حساب التاجر في Adyen.
خطوة توصيل حساب Stripe الخاص بك تظهر اسم المعالج، والمفتاح السري، ونقطة نهاية ويب هوك، وحقل السر التوقيعي
ينشئ Dodo Payments الاتصال ويعرض عنوان URL لـ Webhook Endpoint مخصص له. أضف عنوان URL هذا كوجهة webhook في لوحة معلومات معالج الدفع. ثم الصق Webhook Signing Secret في Dodo Payments واختر Save & continue:
  • Stripe: سر التوقيع لنقطة نهاية webhook التي أضفتها.
  • Adyen: مفتاح HMAC من Customer Area → Webhooks.
حتى تحفظ سر التوقيع، يظهر الاتصال بالحالة Incomplete ضمن Edit Configuration. بعد حفظه، تظهر حالة الاتصال Connected.
بعد الربط، يُخزّن مفتاحك السري بأمان ولا يمكن عرضه أو تغييره. كما لا يمكن تغيير حساب التاجر في Adyen بعد الإعداد. في معالج الدفع، لا تُعد إلا عنوان URL الخاص بـ webhook الذي ينشئه Dodo Payments؛ ولن تتعامل مطلقًا مع البنية التحتية الأساسية مباشرةً.
3

Configure Payment Routing

أضف قواعد توجيه تربط بلدان العملاء بمعالج دفع. يُوجَّه كل بلد إلى معالج دفع واحد فقط:
  • يتولى معالج الدفع الخاص بك المدفوعات من البلدان التي تعيّنها له.
  • يتولى Dodo Payments بقية العالم، أي كل بلد لا توجّهه، بصفته Merchant of Record.
خطوة تكوين توجيه الدفع تعرض Stripe US موجهة للولايات المتحدة و Dodo Payments كافتراضي لبقية العالم
لتعيين بلد واحد أو أكثر إلى معالج دفع، اختر Add Route، واختر المعالج، ثم اختر البلدان. لا يمكن إضافة بلد موجّه بالفعل إلى معالج دفع آخر.
لوحة إضافة مسار لاختيار معالج وبلدان
إرشادات التوجيه
  • يشمل بقية العالم كل بلد لا يملك مسارًا.
  • تتولى مسارات Dodo Payments بصفته Merchant of Record الامتثال والضرائب تلقائيًا.
  • تتطلب المسارات على معالج الدفع الخاص بك إعدادًا ضريبيًا منفصلًا عند الحاجة.
4

Configure Invoice Information

في المدفوعات التي يتم توجيهها عبر معالج الدفع الخاص بك، أنت البائع الظاهر في الفاتورة. أدخل بيانات النشاط التجاري لهذه الفواتير:
  • Registered Business Name (مطلوب).
  • Tax ID (EIN, SSN, etc.) (اختياري): من 3 إلى 32 حرفًا أو رقمًا أو شرطة. تتوفر إمكانية التحقق من التنسيق لأرقام EIN في الولايات المتحدة.
  • Statement Descriptor (مطلوب): ما يراه العملاء في كشف حسابهم البنكي. استخدم من 5 إلى 22 حرفًا أو رقمًا أو مسافة أو _ أو -.
  • Registered Business Address (مطلوب): ابدأ بالكتابة للبحث عن عنوانك، أو أدخله يدويًا.
  • Privacy Policy Link وTerms of Service Link (مطلوبان).
تعرض Invoice Header Preview كيفية ظهور التفاصيل. تنطبق هذه التفاصيل فقط على فواتير المسارات التي يتولاها معالج الدفع الخاص بك. أما المدفوعات الموجّهة إلى Dodo Payments، فتحتفظ بتفاصيل Dodo Payments بصفته Merchant of Record.
خطوة تكوين معلومات الفاتورة مع تفاصيل العمل ومعاينة رأس الفاتورة المباشرة
5

Review and Finish

راجع اتصال معالج الدفع وقواعد التوجيه وتفاصيل الفاتورة. اختر I confirm that the routing and billing details are correct، ثم اختر Finish setup.
خطوة مراجعة الإعداد الخاص بك التي تلخص المعالج والتوجيه وتفاصيل الفاتورة
بعد الإعداد، تعرض بطاقة Bring Your Own Processor الخيار Edit Configuration، حيث يمكنك إضافة معالجات الدفع وتعديل تفاصيل التوجيه والفواتير. لإرسال جميع المدفوعات مجددًا عبر Dodo Payments بصفته Merchant of Record، اختر Edit routing rules، وافتح كل مسار، وأوقف تشغيل Enable processor. يتم تجاوز معالجات الدفع المعطلة أثناء توجيه المدفوعات، ولا يمكن تجديد الاشتراكات على معالج دفع معطل.
إعدادات BYOP بعد التكوين تعرض خيارات تحرير التكوين والتوجيه

​
كيفية عمل التوجيه

يحدد Dodo Payments المسار من بلد فوترة العميل عند إنشاء الدفع. وتنطبق القاعدة نفسها على المدفوعات لمرة واحدة وجلسات الدفع والاشتراكات الجديدة. تستخدم عمليات التجديد معالج الدفع الذي أُنشئت عليه الاشتراكات (راجع Subscriptions). في المسار الذي يتولاه معالج الدفع الخاص بك:
  • تتم الدفعة عبر حسابك لدى معالج الدفع الخاص بك، وبعملة الفوترة.
  • لا يحتسب Dodo Payments الضرائب ولا يحصّلها. وتتحمل مسؤولية الضرائب في ذلك المسار.
  • تعرض الفواتير بيانات النشاط التجاري وبيان الوصف اللذين أعددتهما، من دون تفاصيل Dodo Payments بصفته Merchant of Record.
  • يدفع لك معالج الدفع الخاص بك مباشرةً. ولا يدخل مبلغ الدفع إلى رصيدك في Dodo Payments مطلقًا؛ إذ لا يُسجّل فيه سوى رسوم BYOP للفوترة.
في المسار الذي يتولاه Dodo Payments (بقية العالم)، يكون Dodo Payments هو Merchant of Record المتكامل الخدمات الخاص بك. ويتولى الضرائب والامتثال وفحص الاحتيال وعمليات الدفع المجمّعة، ويوفر لك أدوات لمنع النزاعات والرد عليها. وتتحمل تكلفة النزاعات المتعلقة بهذه المدفوعات.

​
الاشتراكات

يبقى الاشتراك على معالج الدفع الذي أُنشئ عليه. عند التجديد، يخصم Dodo Payments المبلغ من معالج الدفع نفسه باستخدام تفويض الدفع المخزّن عند اشتراك العميل، ولا يعيد تقييم قواعد التوجيه. تمر تحديثات طريقة الدفع للاشتراك عبر المعالج نفسه. كما يتحدد ما إذا كان Dodo Payments سيحتسب الضريبة على الاشتراك عند إنشاء الاشتراك.

​
معرفة معالج الدفع الذي عالج الدفعة

بعد إعداد BYOP، تعرض جدولا Payments وDisputes رمز معالج الدفع (Stripe أو Adyen أو Dodo Payments) في كل صف. وتضيف صفحات تفاصيل الدفع والنزاع حقل Payment Processor، حتى تتمكن من معرفة المسار الذي عالج المعاملة.

​
عمليات رد المبالغ والنزاعات والمدفوعات

ابدأ عمليات رد المبالغ من لوحة معلومات Dodo كالمعتاد. بالنسبة إلى دفعة موجّهة عبر معالج الدفع الخاص بك، يرسل Dodo Payments طلب رد المبلغ إلى ذلك المعالج، الذي يعيد الأموال؛ ولا يُخصم رد المبلغ من رصيدك في Dodo Payments. أما الدفعة الموجّهة إلى Dodo، فيتولى Dodo Payments معالجة رد المبلغ.

​
التحليلات

تشمل تحليلات الإيرادات والضرائب والاشتراكات كلا المسارين، لذا يمكنك رؤية جميع عمليات الفوترة في مكان واحد. تعرض عناصر واجهة النزاعات والمدفوعات النشاط الذي عالجه Dodo فقط. كما يظهر النشاط على معالج الدفع الخاص بك في لوحة معلومات ذلك المعالج.

​
رسوم الفوترة

يفرض Dodo Payments رسوم فوترة BYOP على كل دفعة يتم توجيهها عبر معالج الدفع الخاص بك، لأن Dodo Payments يواصل تشغيل منتجاتك واشتراكاتك وفوترك وتحليلاتك لهذه المدفوعات. المعدل الافتراضي هو 0.5% من المبلغ المكافئ للدفعة بالدولار الأمريكي، ويُؤكَّد المعدل الدقيق عند تفعيل BYOP لحسابك. تظهر الرسوم كإدخال byop_fee في دفتر رصيدك. لمناقشة معدلك، تواصل مع الفريق.

​
الأسئلة الشائعة

Stripe وAdyen. يتطلب كلاهما raw card API access في حسابك، والذي تطلبه من دعم معالج الدفع. راجع دليلي Stripe وAdyen.
نعم. عيّن بلدانًا محددة إلى معالج الدفع الخاص بك واترك الباقي ضمن بقية العالم، الذي يتولاه Dodo Payments بصفته Merchant of Record. يُوجَّه كل بلد إلى معالج دفع واحد فقط.
نعم. في المسارات التي يتولاها معالج الدفع الخاص بك، تظل البائع القانوني وتتحمل مسؤولية الضرائب وعمليات رد المبالغ والامتثال لمعيار PCI وعمليات الدفع لهذه المعاملات.
لا. لا يحتسب Dodo Payments الضرائب ولا يحصّلها في المسارات التي يتولاها معالج الدفع الخاص بك؛ بل تدير الضرائب لهذه المعاملات بنفسك. ويواصل Dodo Payments إدارة الضرائب على المدفوعات الموجّهة إليه بصفته Merchant of Record.
تفشل عمليات التجديد على ذلك المعالج أثناء تعطيله، لأن كل اشتراك يُجدَّد على معالج الدفع الذي أُنشئ عليه. وتظهر عمليات التجديد هذه كمدفوعات فاشلة في لوحة المعلومات.يوقف Dodo Payments أيضًا رسائل البريد الإلكتروني الخاصة باسترداد المدفوعات لهذه الاشتراكات. أعد تفعيل المعالج لاستعادة عمليات التجديد؛ ثم تُستأنف محاولات الاسترداد المتوقفة.

​
البدء

What is Merchant of Record?

تعرّف على كيفية عمل نموذج Merchant of Record المتكامل الخدمات من Dodo Payments.
آخر تعديل في ٢٦ سبتمبر ٢٠٢٦