> ## 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.

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

> قم بتفعيل الوصول إلى واجهة برمجة التطبيقات لبيانات البطاقات الخام على Stripe باستخدام PCI DSS AOC من Dodo Payments، ثم قم بربط حسابك في Stripe مع Bring Your Own Processor (BYOP).

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

## تفعيل الوصول إلى بيانات البطاقات الخام

لتوجيه المدفوعات من خلال حسابك في Stripe بينما تقوم Dodo Payments بإدارة الفوترة من الأعلى، تحتاج Dodo إلى تمرير تفاصيل البطاقة إلى Stripe نيابة عنك باستخدام **واجهات برمجة تطبيقات بيانات البطاقات الخام** من Stripe.

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

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

<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 وقدمها إلى Stripe عندما تطلب الوصول إلى بيانات البطاقات الخام.
</Card>

<Tip>
  **وضع الاختبار لا يتطلب أي وثائق.** يمكنك طلب من Stripe تمكين APIs بيانات البطاقات الخام لـ **وضع الاختبار** فوراً حتى تتمكن من البناء والتحقق من إعداد BYOP الخاص بك. لا يزال الوضع المباشر يتطلب شهادة الامتثال لـ Dodo Payments أعلاه.
</Tip>

طلب الوصول مباشرة من خلال الدليل الرسمي لـ Stripe، وقدم شهادة Dodo Payments AOC عندما يطلب Stripe وثائق PCI:

<Card title="Enabling access to raw card data APIs" icon="stripe" href="https://support.stripe.com/questions/enabling-access-to-raw-card-data-apis">
  دليل Stripe لطلب الوصول إلى واجهة برمجة التطبيقات لبيانات البطاقة الخام على حسابك.
</Card>

## ما ستحتاجه

بمجرد أن يؤكد Stripe الوصول إلى بيانات البطاقات الخام، قم بتوصيل Stripe في **الإعدادات → BYOP**. اجمع قيمتين من لوحة معلومات Stripe الخاصة بك:

| القيمة               | من أين تأتي                 |
| -------------------- | --------------------------- |
| **مفتاح سري**        | المطورون → مفاتيح API       |
| **سر توقيع webhook** | تم إنشاؤه عند إضافة webhook |

<Info>
  يحافظ Stripe على بيانات الاعتماد **التجريبية** و**المباشرة** منفصلة — يتم التبديل باستخدام زر **وضع الاختبار / الوضع المباشر** في لوحة التحكم. أنشئ بيانات الاعتماد في البيئة التي تطابق الوضع الذي تقوم بإعداده في Dodo.
</Info>

## الخطوة 1: احصل على مفتاحك السري

<Steps>
  <Step title="Open API keys">
    في لوحة معلومات Stripe، انتقل إلى **المطورون → مفاتيح API**. استخدم زر **وضع الاختبار / الوضع المباشر** لمطابقة البيئة التي تقوم بإعدادها.
  </Step>

  <Step title="Copy your secret key">
    انسخ **المفتاح السري** — يبدأ بـ `sk_test_` في وضع الاختبار أو `sk_live_` في الوضع المباشر (يعمل مفتاح مقيد، `rk_...`، أيضاً إذا كنت تفضل تحديد الأذونات). ستلصق هذا في حقل **المفتاح السري** في Dodo.
  </Step>
</Steps>

## الخطوة 2: إعداد webhook وسر التوقيع

تقوم Dodo بإنشاء عنوان URL لنقطة نهاية **Webhook** عند حفظ اتصال Stripe. أضفه كـ webhook في Stripe، ثم انسخ سر التوقيع.

<Steps>
  <Step title="Add an endpoint">
    في لوحة معلومات Stripe، انتقل إلى **المطورون → Webhooks** وحدد **إضافة نقطة نهاية**. قم بلصق عنوان URL لنقطة نهاية **Webhook** الذي أنشأته Dodo (يجب أن يكون HTTPS وقابلاً للوصول بشكل عام) وحدد الأحداث للاستماع إليها.
  </Step>

  <Step title="Reveal the signing secret">
    افتح صفحة تفاصيل نقطة النهاية وحدد **عرض السر** لعرض **سر التوقيع** — يبدأ بـ `whsec_`. السر فريد لكل نقطة نهاية، وللنقاط التجريبية والمباشرة أسرار مختلفة.
  </Step>

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

    <Card title="Set up BYOP" icon="shuffle" href="/features/byop">
      اتبع عملية إعداد Bring Your Own Processor الكاملة.
    </Card>
  </Step>
</Steps>

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

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

<AccordionGroup>
  <Accordion title="Do I need my own PCI certification (SAQ D)?">
    لا. لأن **Dodo Payments تتعامل مع بيانات البطاقات الخام نيابة عنك** وهي **متوافقة مع PCI DSS من المستوى 1**، فإنك تقدم **شهادة الامتثال لـ Dodo Payments** إلى Stripe بدلاً من إكمال SAQ D الخاص بك أو الخضوع لتدقيق منفصل.
  </Accordion>

  <Accordion title="Why can't Stripe just enable this by default?">
    إرسال أرقام البطاقات الخام إلى API يجلب النظام المرسل إلى نطاق PCI DSS. يتطلب Stripe إثبات الامتثال لـPCI قبل تمكين واجهات برمجة التطبيقات لبيانات البطاقات الخام حتى تظل بيانات حامل البطاقة محمية. Dodo Payments متوافقة مع **PCI DSS من المستوى 1**، لذا تقدم شهادة الامتثال الخاصة بها كدليل لذلك.
  </Accordion>

  <Accordion title="Can I test BYOP before getting live approval?">
    نعم. اطلب من Stripe تمكين APIs بيانات البطاقات الخام في **وضع الاختبار**، الذي لا يحتاج إلى وثائق PCI، وقم بتوصيل Stripe في وضع الاختبار في Dodo. ستحتاج إلى موافقة الوضع المباشر قبل معالجة المدفوعات الحقيقية.
  </Accordion>

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

## المراجع

* [التصديق على الامتثال لـ PCI DSS من Dodo Payments](https://pub-2a89184e4c954b599464449d23f506bb.r2.dev/dodo-payments-pci-dss-aoc.pdf)
* [دعم Stripe: تمكين الوصول إلى واجهات برمجة التطبيقات لبيانات البطاقات الخام](https://support.stripe.com/questions/enabling-access-to-raw-card-data-apis)
* [Stripe: مفاتيح API](https://docs.stripe.com/keys)
* [Stripe: سر توقيع Webhook](https://docs.stripe.com/webhooks/signature)