المهارات stripe-integration
💳

stripe-integration

آمن 🌐 الوصول إلى الشبكة⚙️ الأوامر الخارجية

دمج مدفوعات Stripe

متاح أيضًا من: wshobson

توفر هذه المهارة إرشادات شاملة لدمج مدفوعات Stripe لتنفيذ عمليات الدفع والدفعات المتكررة والويب هوك وإدارة استرداد الأموال مع أفضل ممارسات التوافق مع PCI.

يدعم: Claude Codex Code(CC)
🥉 73 برونزي
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "stripe-integration". إنشاء جلسة دفع لمنتج بقيمة 49 دولارًا

النتيجة المتوقعة:

يمكنني مساعدتك في إنشاء جلسة دفع Stripe. إليك كود Python:

```python
import stripe

stripe.api_key = 'sk_test_YOUR_KEY'

session = stripe.checkout.Session.create(
payment_method_types=['card'],
line_items=[{
'price_data': {
'currency': 'usd',
'product_data': {'name': 'Premium Widget'},
'unit_amount': 4900, # $49.00 in cents
},
'quantity': 1,
}],
mode='payment',
success_url='https://yoursite.com/success?session_id={CHECKOUT_SESSION_ID}',
cancel_url='https://yoursite.com/cancel',
)

# Redirect user to session.url
```

هذا ينشئ صفحة دفع مستضافة. سيتم إعادة توجيه المستخدم إلى نموذج الدفع الآمن الخاص بـ Stripe.

استخدام "stripe-integration". التعامل مع ويب هوك نجاح الدفع بشكل آمن

النتيجة المتوقعة:

إليك معالج ويب هوك آمن باستخدام Flask مع التحقق من التوقيع:

```python
from flask import Flask, request
import stripe

app = Flask(__name__)
endpoint_secret = 'whsec_YOUR_SECRET'

@app.route('/webhook', methods=['POST'])
def webhook():
payload = request.data
sig_header = request.headers.get('Stripe-Signature')

try:
event = stripe.Webhook.construct_event(
payload, sig_header, endpoint_secret
)
except ValueError:
return 'Invalid payload', 400
except stripe.error.SignatureVerificationError:
return 'Invalid signature', 400

if event['type'] == 'payment_intent.succeeded':
payment_intent = event['data']['object']
# Process the payment - update database, send receipt, etc.

return 'Success', 200
```

التدقيق الأمني

آمن
v1 • 2/25/2026

All 47 static findings are false positives. The skill contains legitimate Stripe payment integration documentation with Python code examples. Detected patterns (backtick execution, hardcoded URLs, API key access) are benign documentation artifacts: backticks are markdown code fences, URLs are placeholder examples, and API key patterns are documented placeholders showing where users should insert their own keys.

1
الملفات التي تم فحصها
457
الأسطر التي تم تحليلها
5
النتائج
1
إجمالي عمليات التدقيق
مشكلات متوسطة المخاطر (3)
External Command Detection in Code Blocks
Static scanner detected Ruby/shell backtick execution patterns at 26 locations. Investigation reveals these are FALSE POSITIVES - the detections are backticks used for markdown code fencing in Python code examples (e.g., `import stripe`, `stripe.api_key = ...`). This is legitimate documentation formatting, not command execution.
Hardcoded URLs in Code Examples
Static scanner detected hardcoded URLs. Investigation reveals these are FALSE POSITIVES - placeholder example URLs like 'https://yourdomain.com/success' in code samples showing users where to configure their own callback URLs.
Environment Variable Access for API Keys
Static scanner detected API key access patterns at lines 81 and 394. Investigation reveals these are FALSE POSITIVES - these are documented placeholders 'sk_test_...' showing users where to insert their own test API keys, a standard documentation practice for Stripe integration guides.
تم تدقيقه بواسطة: claude

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
50
المجتمع
90
الأمان
100
الامتثال للمواصفات

ماذا يمكنك بناءه

تنفيذ دفع التجارة الإلكترونية

إضافة دفع Stripe لتطبيقات الويب لقبول المدفوعات لمرة واحدة مع صفحات دفع مستضافة.

إدارة اشتراكات SaaS

إعداد الفواتير المتكررة لمنتجات SaaS مع الوصول إلى بوابة العملاء وإدارة دورة حياة الاشتراك.

معالجة أحداث الويب هوك

معالجة أحداث الدفع بشكل آمن مع التحقق من التوقيع والتعامل الخالي من التكرار لأنظمة الإنتاج.

جرّب هذه الموجهات

إعداد الدفع الأساسي
Help me set up a basic Stripe checkout flow for a one-time payment of $29. Show me how to create a checkout session and redirect the user.
إنشاء اشتراك
Create a subscription checkout flow for a monthly service at $19/month. Include customer creation and subscription activation.
معالج الويب هوك
Write a secure webhook handler in Python that verifies the Stripe signature and processes payment_intent.succeeded events.
معالجة استرداد الأموال
Show me how to implement partial refunds and handle the refund workflow including the reason codes.

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

  • تحقق دائمًا من تواقيع الويب هوك باستخدام stripe.Webhook.construct_event لمنع الأحداث المزورة
  • استخدم صفحات الدفع المستضافة من Stripe لتقليل عبء التوافق مع PCI
  • تعامل مع أحداث الويب هوك بشكل خالٍ من التكرار عن طريق التحقق من معرفات الأحداث المكررة قبل المعالجة
  • خزن فقط معرفات طرق الدفع، وليس بيانات البطاقة الخام أبدًا، للحفاظ على التوافق مع PCI
  • استخدم مفاتيح وضع الاختبار أثناء التطقق وتحقق من جميع تدفقات الدفع باستخدام أرقام بطاقات الاختبار

تجنب

  • لا تعتمد على تأكيد الدفع من جانب العميل فقط - تحقق دائمًا عبر الويب هوك
  • لا تضمّن مفاتيح API بشكل ثابت في الكود المصدري - استخدم متغيرات البيئة أو إدارة الأسرار
  • لا تعالج نفس حدث الويب هوك مرتين - نفذ فحوصات عدم التكرار
  • لا تستخدم مفاتيح API للإنتاج في وضع الاختبار أو بطاقات الاختبار في الإنتاج

الأسئلة المتكررة

ما الفرق بين جلسات الدفع ونوايا الدفع؟
تستخدم جلسات الدفع صفحة الدفع المستضافة من Stripe لأقل جهد تنفيذ وتوافق مع PCI. نوايا الدفع تمنحك التحكم الكامل لبناء واجهة دفع مخصصة داخل تطبيقك.
كيف أتحقق من أن الويب هوك يأتي فعليًا من Stripe؟
استخدم stripe.Webhook.construct_event() مع سر نقطة النهاية الخاصة بك للتحقق من رأس Stripe-Signature. هذا يضمن أن الطلب جاء بالفعل من Stripe.
ما هي أرقام بطاقات الاختبار التي يمكنني استخدامها؟
استخدم 4242424242424242 للمدفوعات الناجحة، 4000000000000002 للبطاقات المرفوضة، و4000002500003155 للبطاقات التي تتطلب 3D Secure.
كيف أتعامل مع مصادقة العملاء القوية (SCA) للعملاء الأوروبيين؟
يتعامل Stripe تلقائيًا مع SCA عند استخدام جلسات الدفع أو تمكين automatic_payment_methods. للتدفقات المخصصة، استخدم Stripe Elements مع تدفقات المصادقة الجديدة.
هل يمكنني معالجة استردادات أموال جزئية؟
نعم، قدم معلمة amount بالسنتات عند إنشاء استرداد الأموال. بدونها، يعالج Stripe استردادًا كاملاً. يمكنك إصدار استردادات جزئية متعددة حتى مبلغ الدفع الأصلي.
كيف أمنح العملاء الوصول لإدارة اشتراكاتهم؟
استخدم بوابة الفواتير من Stripe عن طريق استدعاء stripe.billing_portal.Session.create() مع معرف العميل. هذا يوفر صفحة مستضافة من Stripe للعملاء لتحديث طرق الدفع أو إلغاء أو إيقاف الاشتراكات مؤقتًا.

تفاصيل المطور

المؤلف

sickn33

الترخيص

MIT

مرجع

main

بنية الملفات

📄 SKILL.md