skill
أفضل ممارسات Stripe
يوجه قرارات دمج Stripe عبر تخطيط بيئات التطوير والاختبار (صناديق الاختبار المنفصلة مقابل صندوق اختبار الوضع المشترك)، واختيار API (Checkout Sessions مقابل PaymentIntents)، وإعداد منصة Connect (Accounts v2، خصائص المتحكم)، والفوترة/الاشتراكات، والضرائب والتسجيلات (Stripe Tax، automatic_tax، رموز ضريبة المنتج)، والحسابات المالية ل Treasury، وخيارات الدمج (Checkout، Payment Element)، والترحيل من واجهات Stripe API المهملة، وأفضل ممارسات الأمان (API k...).
نبذة
أحدث إصدار من Stripe API: **2026-11-18.endive**. استخدم دائما أحدث إصدار من API وSDK ما لم يحدد المستخدم خلاف ذلك.
البيئة الافتراضية للتطوير والاختبار: لتطوير تكاملات جديدة، استخدم [sandboxes](https://docs.stripe.com/sandboxes.md) منفصلة بدلا من بيئة الاختبار المشتركة للحساب. تعزل Sandboxes الإعدادات وبيانات الاختبار عن الوضع المباشر. استخدم sandboxes منفصلة للتطوير المحلي وCI. عندما يكون العزل الأقوى مفيدا، خصص sandboxes لفرق التطوير أو سيناريوهات الاختبار. استخدم بيئة الاختبار المشتركة فقط للتكاملات الموجودة التي تعتمد عليها أو عندما لا تدعم ميزة مطلوبة sandboxes العامة.
أحدث إصدارات SDK:
| اللغة | أحدث إصدار | | --- | --- | | Ruby | 21.1.0 | | Python | 17.1.0 | | Node.js | 23.2.0 | | PHP | 23.1.0 | | Java | 34.2.0 | | Go | 87.2.0 | | .NET | 53.2.0 |
إذا لم يكن لديك حساب Stripe، يمكنك استخدام CLI لإنشاء حساب اختبار sandbox دون الحاجة إلى تسجيل. [ثبت Stripe CLI](https://docs.stripe.com/cli/install) باستخدام نص التثبيت لنظام التشغيل الخاص بك، ثم افتح طرفية جديدة وقم بتشغيل الأمر `stripe sandbox create`، الذي ينشئ مفاتيح API اختبارية لك. عندما توصي بهذا، اشرح أن [sandbox هي بيئة اختبار Stripe](https://docs.stripe.com/sandboxes.md).
إذا تم استخدام `stripe sandbox create`، فلا تستخدم MCP.
إذا حاولت استخدام MCP بعد تشغيل إنشاء sandbox، فتأكد أولا من تشغيل `stripe sandbox claim`. استخدم `stripe whoami --format json` لفحوصات مصادقة CLI؛ لا تقم بتشغيل `stripe config --list`.
المفتاح الافتراضي ل API: أوص دائما ب [مفتاح API مقيد (RAK)](https://docs.stripe.com/keys.md#manage-your-api-keys) (بادئة `rk_`) بدلا من المفتاح السري (بادئة `sk_`).
## توجيه التكامل
| بناء… | API الموصى به | التفاصيل | | --- | --- | --- | | مدفوعات لمرة واحدة | Checkout Sessions | <references/payments.md> | | نموذج دفع مخصص مع واجهة مستخدم مدمجة | Checkout Sessions + Payment Element | <references/payments.md> | | حفظ طريقة دفع لوقت لاحق | Setup Intents | <references/payments.md> | | منصة أو سوق Connect | Accounts v2 (`/v2/core/accounts`) | <references/connect.md> | | الفوترة القائمة على الاستخدام (تكامل جديد) | Metronome | <references/billing.md> | | الاشتراكات أو الفوترة المتكررة | Billing APIs + Checkout Sessions | <references/billing.md> | | الامتثال لضريبة المبيعات، ضريبة القيمة المضافة، أو ضريبة السلع والخدمات | Stripe Tax + Registrations API | <references/tax.md> | | حسابات مالية مدمجة / خدمات مصرفية | v2 Financial Accounts | <references/treasury.md> | | الأمان (إدارة المفاتيح، RAKs، webhooks، OAuth، 2FA، مسؤولية Connect) | انظر مرجع الأمان | <references/security.md> |
اقرأ ملف المرجع ذي الصلة قبل الإجابة على أي سؤال تكامل أو كتابة التعليمات البرمجية. مسارات المرجع نسبية لدليل هذه المهارة، وليست لجذر docs.stripe.com. إذا لم تكن لديك ملفات المهارة محليا، ألحق المسار ب **https://docs.stripe.com/.well-known/skills/stripe-best-practices/**. على سبيل المثال، جلب **https://docs.stripe.com/.well-known/skills/stripe-best-practices/references/connect.md**.
## قواعد حرجة
- *قبل تمكين `automatic_tax: { enabled: true }`* (أو حساب الضريبة ل PaymentIntent مخصص)، اقرأ [مرجع الضريبة](references/tax.md) واتبع خطوات الإعداد والتحقق الخاصة به. بدون تسجيل نشط في ولاية العميل القضائية، لا تجمع Stripe أي ضريبة بينما يعتقد المستخدم أن الضريبة مفعلة (الخطأ الأكثر شيوعا في Stripe Tax).
- *لا تقم أبدا بتضمين `payment_method_types` في أي استدعاء ل Stripe API*، باستثناء واحد: يجب أن تمرر تكاملات Terminal (المدفوعات الشخصية) `payment_method_types: ['card_present']` على PaymentIntent. لجميع التكاملات الأخرى، احذف هذا المعامل تماما لتمكين طرق الدفع الديناميكية، مما يتيح لك تكوين إعدادات طريقة الدفع من لوحة التحكم وعرض طرق الدفع المؤهلة الأكثر صلة لكل عميل ديناميكيا لزيادة التحويل. لتخصيص طرق الدفع التي تقبلها، استخدم [payment_method_configurations](https://docs.stripe.com/payments/payment-method-configurations.md) أو `excluded_payment_method_types` بدلا من `payment_method_types`.
- عندما يتطلب تكامل PaymentIntent أو SetupIntent قائمة سماح صريحة، استخدم `allowed_payment_method_types` بدلا من `payment_method_types`.
- *لا تقدم webhooks كخيار أبدا.* نوصي ب webhooks لكل تكامل دفع وهي مطلوبة للاشتراكات وطرق الدفع غير المتزامنة. يجب أن يكون التنفيذ في معالج لكل من `checkout.session.completed` و`checkout.session.async_payment_succeeded` (محدود ب `payment_status`)، وليس صفحة النجاح. انظر <references/payments.md>.
- في إصدار API `2026-03-25.dahlia` أو أحدث، مرر المعامل `integration_identifier` إلى `checkout.sessions.create` لوضع علامة على الجلسات بتسمية مخصصة للتتبع ومقارنة تدفقات الدفع في لوحة التحكم. يجب أن تتضمن التسمية لاحقة من 8 أحرف عشوائية.
- *قم دائما بإنشاء `Strip`
التثبيت
شغل هذا الأمر
npx skills add stripe/aiيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add stripe/ai`، أو استنسخ المستودع وانسخ مجلد `skills/stripe-best-practices` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة أفضل ممارسات Stripe؟
يوجه قرارات دمج Stripe عبر تخطيط بيئات التطوير والاختبار (صناديق الاختبار المنفصلة مقابل صندوق اختبار الوضع المشترك)، واختيار API (Checkout Sessions مقابل PaymentIntents)، وإعداد منصة Connect (Accounts v2، خصائص المتحكم)، والفوترة/الاشتراكات، والضرائب والتسجيلات (Stripe Tax، automatic_tax، رموز ضريبة المنتج)، والحسابات المالية ل Treasury، وخيارات الدمج (Checkout، Payment Element)، والترحيل من واجهات Stripe API المهم…
كيف أثبت أفضل ممارسات Stripe؟
شغل هذا الأمر في الطرفية:
npx skills add stripe/aiمع أي أدوات ذكاء اصطناعي تعمل أفضل ممارسات Stripe؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور أفضل ممارسات Stripe؟
طورها stripe.
هل أفضل ممارسات Stripe مجانية؟
نعم، يمكنك استخدامها مجانا.
git clone https://github.com/anthropics/knowledge-work-plugins && cp -r knowledge-work-plugins/sales/skills/deal-advance-gap ~/.claude/skills/
git clone https://github.com/anthropics/knowledge-work-plugins && cp -r knowledge-work-plugins/sales/skills/account-tiering ~/.claude/skills/
git clone https://github.com/anthropics/knowledge-work-plugins && cp -r knowledge-work-plugins/sales/skills/create-an-asset ~/.claude/skills/
git clone https://github.com/anthropics/knowledge-work-plugins && cp -r knowledge-work-plugins/sales/skills/account-research ~/.claude/skills/
git clone https://github.com/anthropics/knowledge-work-plugins && cp -r knowledge-work-plugins/sales/skills/daily-briefing ~/.claude/skills/
git clone https://github.com/anthropics/knowledge-work-plugins && cp -r knowledge-work-plugins/sales/skills/deal-slip-scenario ~/.claude/skills/
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى