> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Adyen - الوصول إلى واجهة برمجة التطبيقات للاتصال والبطاقة الخام

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

<Note>
  هذا الدليل ينطبق عندما تقوم بتوصيل **Adyen** كمُعالج خاص بك من خلال [إحضار المعالج الخاص بك (BYOP)](/features/byop). [تواصل معنا](mailto:founders@dodopayments.com) إذا كنت بحاجة إلى مساعدة.
</Note>

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

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

<Card title="Dodo Payments PCI DSS Attestation of Compliance (AOC)" icon="file-shield" href="https://pub-2a89184e4c954b599464449d23f506bb.r2.dev/dodo-payments-pci-dss-aoc.pdf">
  قم بتنزيل شهادة الامتثال الحالية لـ Dodo Payments وقدمها إلى دعم Adyen لتمكين الوصول إلى بيانات البطاقة الخام.
</Card>

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

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

لتوصيل Adyen في **الإعدادات → BYOP**، قم بتجميع ثلاث قيم من منطقة العملاء لـ Adyen:

| القيمة          | مصدرها                       |
| --------------- | ---------------------------- |
| **API key**     | مطورين → بيانات اعتماد API   |
| **حساب التاجر** | معرف حساب التاجر في Adyen    |
| **مفتاح HMAC**  | يتم توليده عند إعداد التنبيه |

<Info>
  يحتفظ Adyen ببيانات الاعتماد لـ **الاختبار** (`ca-test.adyen.com`) و **الإنتاج** (`ca-live.adyen.com`) منفصلة. قم بتوليد بيانات الاعتماد في البيئة التي تناسب الوضع الذي تقوم بإعداده في Dodo.
</Info>

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

<Steps>
  <Step title="Open API credentials">
    في منطقة العملاء لـ Adyen، انتقل إلى **مطورين → بيانات اعتماد API**. تحتاج إلى دور **إدارة بيانات اعتماد API** أو **مدير التاجر**.
  </Step>

  <Step title="Select your credential">
    اختر علامة التبويب **المدفوعات** وحدد اسم مستخدم بيانات اعتمادك (يبدو مثل `ws_123456@Company.YourCompanyAccount`).
  </Step>

  <Step title="Generate the key">
    اذهب إلى **إعدادات الخادم → المصادقة**، افتح علامة التبويب **مفتاح API**، وحدد **توليد مفتاح API**.
  </Step>

  <Step title="Copy it immediately">
    انسخ المفتاح واحفظه بأمان؛ لا يمكنك نسخه مرة أخرى بعد مغادرة الصفحة. يُفعّل مفتاح جديد فورًا، ويبقى المفتاح السابق يعمل لمدة 24 ساعة.
  </Step>
</Steps>

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

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

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

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

<Steps>
  <Step title="Create a webhook">
    في منطقة العملاء، انتقل إلى **مطورين → التنبيهات** وحدد **إنشاء تنبيه جديد**. من القائمة، حدد **إضافة** لنوع التنبيه **القياسي**.
  </Step>

  <Step title="Configure the webhook">
    * أدخل وصفًا.
    * قم بتبديل **تمكين** لتفعيله.
    * تحت **إعدادات الخادم**، الصق عنوان URL لنقطة نهاية التنبيه الذي تولده Dodo في حقل **URL** (يجب أن يكون HTTPS ومتاحًا بشكل عام).
  </Step>

  <Step title="Generate the HMAC key">
    تحت **الأمان**، في قسم **مفتاح HMAC**، حدد **توليد** لإنشاء مفتاح HMAC جديد. انسخه واحفظه بأمان؛ لن تتمكن من نسخه مرة أخرى لاحقًا. ثم اختر **حفظ الإعدادات**.
  </Step>

  <Step title="Paste the HMAC key into Dodo">
    عد إلى **الإعدادات → BYOP**، والصق مفتاح HMAC في حقل **سر توقيع التنبيه** لإتمام الاتصال.

    <Card title="Set up BYOP" icon="shuffle" href="/features/byop">
      اتبع التدفق الكامل لإعداد إحضار المعالج الخاص بك.
    </Card>
  </Step>
</Steps>

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

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

<AccordionGroup>
  <Accordion title="What is the HMAC key for?">
    يقوم Adyen بتوقيع كل تنبيه بتوقيع HMAC حتى يتمكن المستلم من التحقق من صحة الإشعار وأصله. يستخدم Dodo مفتاح HMAC الذي تقدمه للتحقق من التنبيهات من حسابك في Adyen.
  </Accordion>

  <Accordion title="I lost my API key or HMAC key, what now?">
    لا يمكن استرجاع أي منهما بعد الإنشاء. قم بتوليد مفتاح API جديد تحت **مطورين → بيانات اعتماد API**، أو مفتاح HMAC جديد في إعدادات التنبيه، ثم قم بتحديث القيمة في **الإعدادات → BYOP**.
  </Accordion>

  <Accordion title="Do test and live use the same credentials?">
    لا. قم بتوليد بيانات الاعتماد في البيئة المطابقة، اختبار (`ca-test.adyen.com`) أو إنتاج (`ca-live.adyen.com`)، وقم بإعدادها في الوضع المقابل في Dodo.
  </Accordion>
</AccordionGroup>

## المراجع

* [Adyen: بيانات اعتماد API](https://docs.adyen.com/development-resources/api-credentials/)
* [Adyen: إعداد وإدارة التنبيهات](https://docs.adyen.com/development-resources/webhooks/configure-and-manage)