تفعيل Raw Card Data Access
لتوجيه المدفوعات عبر حساب Stripe الخاص بك، يرسل Dodo Payments تفاصيل البطاقة إلى Stripe نيابةً عنك من خلال raw card data APIs في Stripe. بشكل افتراضي، لا يمكن لحساب Stripe إرسال أرقام البطاقات الخام (PANs) إلى واجهات API الخاصة به. لا تفعّل Stripe هذا الوصول إلا بعد التأكد من أن الأنظمة التي تتعامل مع raw card data متوافقة مع PCI DSS. مع BYOP، يكون النظام الذي يتعامل مع بيانات البطاقة هو Dodo Payments، وهو متوافق مع PCI DSS Level 1، لذلك تثبت الامتثال من خلال شهادة Dodo Payments بدلاً من شهادتك الخاصة. تطلب هذا الوصول مرة واحدة لكل حساب. عند طلب الوصول، تطلب Stripe وصفًا موجزًا لكيفية التعامل مع بيانات البطاقات. اذكر أن Dodo Payments، مزود الدفع المتوافق مع PCI DSS Level 1، يعالج بيانات البطاقات الخام، وأن أنظمتك الخاصة لا تخزّن أرقام البطاقات الخام ولا تتعامل معها. وبما أنك تستعين بالكامل بمصادر خارجية لمعالجة البطاقات عبر Dodo Payments، فلست بحاجة إلى SAQ D الخاص بك إذا كنت مؤهلًا لـ SAQ A. أرسل SAQ A الخاص بك، مع إدراج Dodo Payments كمزود خدمة تابع لجهة خارجية في الجزء 2f، وأرفق Dodo Payments Attestation of Compliance (AOC) كدليل داعم:Dodo Payments PCI DSS Attestation of Compliance (AOC)
نزّل أحدث إصدار من Dodo Payments AOC وأرسله إلى Stripe عند طلب raw card data access.
Enabling access to raw card data APIs
دليل Stripe لطلب الوصول إلى raw card data API في حسابك.
ما ستحتاج إليه
بعد أن تؤكد Stripe إمكانية الوصول إلى raw card data، اربط Stripe من Settings → BYOP. ستحتاج إلى قيمتين من Stripe Dashboard:تحتفظ Stripe ببيانات اعتماد وضع sandbox (الاختبار) والوضع المباشر بشكل منفصل. استخدم Stripe sandbox مع وضع اختبار Dodo Payments، واستخدم وضع Stripe المباشر مع وضع Dodo Payments المباشر.
الخطوة 1: الحصول على Secret Key الخاص بك
1
Open API Keys
في Stripe Dashboard، افتح صفحة API keys. بدّل بين وضع sandbox والوضع المباشر ليتوافق ذلك مع وضع Dodo Payments الذي تقوم بإعداده.
2
Copy Your Secret Key
انسخ Secret key. يبدأ المفتاح بـ
sk_test_ في sandbox وبـ sk_live_ في الوضع المباشر. استخدم مفتاحًا سريًا عاديًا؛ المفاتيح المقيّدة (rk_...) غير مدعومة. في الوضع المباشر، تعرض Stripe مفتاحًا سريًا تنشئه مرة واحدة فقط، لذا انسخه قبل إغلاق مربع الحوار.الصق المفتاح في حقل Secret Key في Dodo Payments.الخطوة 2: إعداد Webhook وSigning Secret
عند حفظ اتصال Stripe، ينشئ Dodo Payments عنوان URL لـ Webhook Endpoint. أضفه إلى Stripe كنقطة نهاية webhook، ثم انسخ signing secret الخاص بنقطة النهاية.1
Create an Event Destination
في Stripe Dashboard، افتح علامة التبويب Webhooks في Workbench وحدد Create an event destination. حدد Your account، ثم حدد جميع الأحداث. يحتاج Dodo Payments إلى نقطة النهاية لاستقبال كل نوع من الأحداث.
2
Add the Endpoint URL
اختر Webhook endpoint كنوع للوجهة. في Endpoint URL، الصق عنوان URL لـ Webhook Endpoint الذي أنشأه Dodo Payments. تقبل Stripe عناوين HTTPS المتاحة للعامة فقط.
3
Reveal the Signing Secret
في صفحة إعدادات نقطة النهاية، حدد Reveal secret لعرض Signing secret. يبدأ بـ
whsec_. لكل نقطة نهاية secret خاص بها، ولذلك تختلف نقاط نهاية sandbox والوضع المباشر في secrets.4
Paste the Signing Secret into Dodo
في Settings → BYOP، الصق signing secret في حقل Webhook Signing Secret، ثم حدد Save & continue لإنهاء الاتصال.
Set up BYOP
اتبع عملية الإعداد الكاملة لـ Bring Your Own Processor.
الأسئلة الشائعة
Do I need my own PCI certification (SAQ D)?
Do I need my own PCI certification (SAQ D)?
لا، إذا كنت مؤهلًا لـ SAQ A. يتولى Dodo Payments معالجة بيانات البطاقات الخام نيابةً عنك وهو متوافق مع PCI DSS Level 1، لذا أرسل SAQ A الخاص بك مع إدراج Dodo Payments في الجزء 2f، إلى جانب Dodo Payments Attestation of Compliance (AOC)، بدلًا من إكمال SAQ D أو إجراء تدقيق منفصل.
Why doesn't Stripe enable this by default?
Why doesn't Stripe enable this by default?
يؤدي إرسال أرقام البطاقات الخام إلى API إلى إدخال النظام المُرسِل ضمن نطاق PCI DSS. تتطلب Stripe إثبات التوافق مع PCI قبل تفعيل raw card data APIs، لضمان بقاء بيانات حاملي البطاقات محمية. يتوافق Dodo Payments مع PCI DSS Level 1، ولذلك تقدم Dodo Payments AOC كإثبات.
Can I test BYOP before getting live approval?
Can I test BYOP before getting live approval?
نعم. اطلب من Stripe تفعيل raw card data APIs في وضع الاختبار، إذ لا يتطلب ذلك مستندات PCI، ثم اربط Stripe في وضع الاختبار في Dodo Payments. ستحتاج إلى موافقة الوضع المباشر قبل معالجة المدفوعات الحقيقية.
I lost my secret key or signing secret, what now?
I lost my secret key or signing secret, what now?
لعرض signing secret مرة أخرى، افتح نقطة نهاية webhook في Stripe وحدد Reveal secret. لتحديثه في Dodo Payments، افتح Settings → BYOP، وحدد Edit Configuration، ثم حرر اتصال Stripe، والصق secret في Webhook Signing Secret، وحدد Save & continue.إذا فقدت secret key مباشرًا أنشأته، فلن تتمكن Stripe من عرضه مرة أخرى، لذا قم بتدويره أو أنشئ مفتاحًا جديدًا من صفحة API keys. لا تتيح لك لوحة تحكم Dodo تغيير secret key محفوظ. لاستبدال secret key في اتصال موجود، تواصل مع support@dodopayments.com.