技能 stripe-integration
💳

stripe-integration

安全 🌐 網路存取⚙️ 外部命令

دمج مدفوعات Stripe

也可從以下取得: wshobson

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

支援: Claude Codex Code(CC)
📊 69 充足
1

下載技能 ZIP

2

在 Claude 中上傳

前往 設定 → 功能 → 技能 → 上傳技能

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
內容
22
社群
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 للعملاء لتحديث طرق الدفع أو إلغاء أو إيقاف الاشتراكات مؤقتًا.

開發者詳情

檔案結構

📄 SKILL.md