الانتقال إلى المحتوى الرئيسي
هذا الدليل ينطبق عندما تقوم بتوصيل Adyen كمُعالج خاص بك من خلال إحضار المعالج الخاص بك (BYOP). تواصل معنا إذا كنت بحاجة إلى مساعدة.

​
تمكين الوصول إلى بيانات البطاقة الخام

قبل أن يتمكن Dodo من توجيه الدفعات عبر Adyen، يحتاج حسابك على Adyen إلى وصول إلى بيانات البطاقة الخام مُفعل. Adyen يُقفلها خلف الامتثال لمعايير PCI DSS. نظرًا لأن Dodo Payments تتعامل مع بيانات البطاقة الخام نيابة عنك وتلتزم بمعايير PCI DSS المستوى 1، تقدم شهادة الامتثال (AOC) لـ Dodo Payments إلى Adyen — لست بحاجة إلى شهادتك الخاصة.

Dodo Payments PCI DSS Attestation of Compliance (AOC)

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

​
ما الذي ستحتاج إليه

لتوصيل Adyen في الإعدادات → BYOP، قم بتجميع ثلاث قيم من منطقة العملاء لـ Adyen:
القيمةمصدرها
API keyمطورين → بيانات اعتماد API
حساب التاجرمعرف حساب التاجر في Adyen
مفتاح HMACيتم توليده عند إعداد التنبيه
يحتفظ Adyen ببيانات الاعتماد لـ الاختبار (ca-test.adyen.com) و الإنتاج (ca-live.adyen.com) منفصلة. قم بتوليد بيانات الاعتماد في البيئة التي تناسب الوضع الذي تقوم بإعداده في Dodo.

​
الخطوة 1: توليد مفتاح API

1

Open API credentials

في منطقة العملاء لـ Adyen، انتقل إلى مطورين → بيانات اعتماد API. تحتاج إلى دور إدارة بيانات اعتماد API أو مدير التاجر.
2

Select your credential

اختر علامة التبويب المدفوعات وحدد اسم مستخدم بيانات اعتمادك (يبدو مثل ws_123456@Company.YourCompanyAccount).
3

Generate the key

اذهب إلى إعدادات الخادم → المصادقة، افتح علامة التبويب مفتاح API، وحدد توليد مفتاح API.
4

Copy it immediately

انسخ المفتاح واحفظه بأمان؛ لا يمكنك نسخه مرة أخرى بعد مغادرة الصفحة. يُفعّل مفتاح جديد فورًا، ويبقى المفتاح السابق يعمل لمدة 24 ساعة.

​
الخطوة 2: العثور على حساب التاجر الخاص بك

حساب التاجر هو المعرف الذي يستخدمه Adyen لمعالجة معاملاتك. يظهر في محدد الحساب أعلى منطقة العملاء (على سبيل المثال، YourCompany_ECOM). ستلصق هذا في حقل حساب التاجر في Dodo.

​
الخطوة 3: إعداد التنبيه ومفتاح HMAC

يقوم Dodo بتوليد عنوان URL لـ نقطة نهاية التنبيه عندما تقوم بحفظ اتصال Adyen. أضفه كتنبيه في Adyen وقم بتوليد مفتاح HMAC. تحتاج إلى دور مدير التاجر أو مندمج تقني للتاجر.
1

Create a webhook

في منطقة العملاء، انتقل إلى مطورين → التنبيهات وحدد إنشاء تنبيه جديد. من القائمة، حدد إضافة لنوع التنبيه القياسي.
2

Configure the webhook

  • أدخل وصفًا.
  • قم بتبديل تمكين لتفعيله.
  • تحت إعدادات الخادم، الصق عنوان URL لنقطة نهاية التنبيه الذي تولده Dodo في حقل URL (يجب أن يكون HTTPS ومتاحًا بشكل عام).
3

Generate the HMAC key

تحت الأمان، في قسم مفتاح HMAC، حدد توليد لإنشاء مفتاح HMAC جديد. انسخه واحفظه بأمان؛ لن تتمكن من نسخه مرة أخرى لاحقًا. ثم اختر حفظ الإعدادات.
4

Paste the HMAC key into Dodo

عد إلى الإعدادات → BYOP، والصق مفتاح HMAC في حقل سر توقيع التنبيه لإتمام الاتصال.

Set up BYOP

اتبع التدفق الكامل لإعداد إحضار المعالج الخاص بك.
بعد الحفظ، استخدم تحقق من الاتصال في Dodo لإجراء مكالمة اختبار ضد Adyen وتأكيد صحة مفتاح API، وحساب التاجر، ومفتاح HMAC قبل بدء التشغيل الفعلي.

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

يقوم Adyen بتوقيع كل تنبيه بتوقيع HMAC حتى يتمكن المستلم من التحقق من صحة الإشعار وأصله. يستخدم Dodo مفتاح HMAC الذي تقدمه للتحقق من التنبيهات من حسابك في Adyen.
لا يمكن استرجاع أي منهما بعد الإنشاء. قم بتوليد مفتاح API جديد تحت مطورين → بيانات اعتماد API، أو مفتاح HMAC جديد في إعدادات التنبيه، ثم قم بتحديث القيمة في الإعدادات → BYOP.
لا. قم بتوليد بيانات الاعتماد في البيئة المطابقة، اختبار (ca-test.adyen.com) أو إنتاج (ca-live.adyen.com)، وقم بإعدادها في الوضع المقابل في Dodo.

​
المراجع

آخر تعديل في ١٨ يونيو ٢٠٢٦