skill

أفضل ممارسات Stripe

يوجه قرارات دمج Stripe عبر تخطيط بيئات التطوير والاختبار (صناديق الاختبار المنفصلة مقابل صندوق اختبار الوضع المشترك)، واختيار API (Checkout Sessions مقابل PaymentIntents)، وإعداد منصة Connect (Accounts v2، خصائص المتحكم)، والفوترة/الاشتراكات، والضرائب والتسجيلات (Stripe Tax، automatic_tax، رموز ضريبة المنتج)، والحسابات المالية ل Treasury، وخيارات الدمج (Checkout، Payment Element)، والترحيل من واجهات Stripe API المهملة، وأفضل ممارسات الأمان (API k...).

stripe103,939+ تثبيتموثوق

نبذة

أحدث إصدار من 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

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `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 مجانية؟

نعم، يمكنك استخدامها مجانا.

أصول ذات صلة

مختارات أخرى في المبيعات وإدارة العملاء.

كل بدائل أفضل ممارسات Stripe ←
skillclaude_appclaude_codeclaude_api
git clone https://github.com/anthropics/knowledge-work-plugins && cp -r knowledge-work-plugins/sales/skills/deal-advance-gap ~/.claude/skills/
فجوة تقدم الصفقة
فحص استباقي للفجوات في فرصة معينة - تحديد ما ينقص بالضبط لدفعها إلى المرحلة التالية وإتمامها، مع تحديد المسؤوليات والجداول الزمنية. يستخدم عندما يسأل…★ 4.8 · 2,500+
skillclaude_appclaude_codeclaude_api
git clone https://github.com/anthropics/knowledge-work-plugins && cp -r knowledge-work-plugins/sales/skills/account-tiering ~/.claude/skills/
تصنيف الحسابات
قم بتقييم وتصنيف قائمة من الحسابات (أو محفظتك الكاملة) بناء على مدى توافقها مع ملف تعريف العميل المثالي (ICP) وإشارات التفاعل لتحديد أولويات قضاء الوق…★ 4.8 · 2,500+
skillclaude_appclaude_codeclaude_api
git clone https://github.com/anthropics/knowledge-work-plugins && cp -r knowledge-work-plugins/sales/skills/create-an-asset ~/.claude/skills/
إنشاء أصل
أنشئ عرضا تقديميا للعملاء، أو صفحة واحدة، أو مواد ترويجية بناء على بيانات حسابك، وملاحظات المكالمات، والمواد المعتمدة، دون أرقام مختلقة. استخدم هذه ال…★ 4.8 · 2,500+
skillclaude_appclaude_codeclaude_api
git clone https://github.com/anthropics/knowledge-work-plugins && cp -r knowledge-work-plugins/sales/skills/account-research ~/.claude/skills/
بحث الحسابات
ابحث عن شركة مستهدفة واختياريا عن جهة اتصال محددة - نظرة عامة على الشركة، آخر الأخبار، الأولويات المحتملة، ومدى توافقها مع ملف تعريف العميل المثالي (I…★ 4.8 · 2,500+
skillclaude_appclaude_codeclaude_api
git clone https://github.com/anthropics/knowledge-work-plugins && cp -r knowledge-work-plugins/sales/skills/daily-briefing ~/.claude/skills/
ملخص يومي
ملخص صباحي - اجتماعات اليوم مع سياق الحسابات، الفرص التي ستغلق قريبا مع علامات ركود، رسائل البريد الإلكتروني للعملاء المنتظرة، وأهم إجراءات اليوم. يست…★ 4.8 · 2,500+
skillclaude_appclaude_codeclaude_api
git clone https://github.com/anthropics/knowledge-work-plugins && cp -r knowledge-work-plugins/sales/skills/deal-slip-scenario ~/.claude/skills/
سيناريو قسيمة الصفقة
نمذجة ما يحدث لعددك إذا تأجلت صفقة، أو تقلصت، أو ألغيت - تأثير الحصة، وتغير نسبة التغطية، وخط الأنابيب البديل المطلوب للبقاء على المسار الصحيح. استخدم…★ 4.8 · 2,500+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في المبيعات وإدارة العملاء