技能 stripe-handler
💳

stripe-handler

低風險 ⚙️ 外部命令🔑 環境變數

Реализация пользовательских платежей Stripe

Пользовательские платежные потоки для разовых продуктов сложно безопасно реализовать. Этот навык предоставляет паттерны для сессий оформления заказа Stripe, обработки веб-хуков и фоновой обработки с Inngest.

支援: Claude Codex Code(CC)
⚠️ 66
1

下載技能 ZIP

2

在 Claude 中上傳

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

3

開啟並開始使用

測試它

正在使用「stripe-handler」。 Создать оплату для электронной книги за $99 с типом метаданных ebook.

預期結果:

  • Описывает обязательные поля сессии оформления заказа, такие как mode, customer email, line items и metadata.
  • Указывает на успешные URL и URL отмены, которые используют NEXT_PUBLIC_APP_URL.
  • Отмечает, что сервер возвращает размещенный URL оплаты клиенту.

正在使用「stripe-handler」。 Как тестировать веб-хуки локально?

預期結果:

  • Перечисляет шаги Stripe CLI: вход, прослушивание с пересылкой на localhost, затем триггер checkout.session.completed.
  • Объясняет, что секрет веб-хука из stripe listen нужно поместить в STRIPE_WEBHOOK_SECRET.

安全審計

低風險
v6 • 1/21/2026

Static analysis flagged command execution and environment access patterns in documentation. Review shows Stripe CLI examples and standard environment variable guidance with no executable code. No evidence of data exfiltration or malicious intent was found.

3
已掃描檔案
1,123
分析行數
4
發現項
6
審計總數
低風險問題 (2)
Stripe CLI commands in documentation
Markdown shows Stripe CLI commands for local webhook testing. No command execution occurs in the skill.
Environment variable references in documentation
Documentation lists required Stripe environment variables and example URLs for configuration. This is standard setup guidance.

風險因素

偵測到的模式

Heuristic combination in documentation
審計者: codex 查看審計歷史 →

品質評分

38
架構
100
可維護性
87
內容
21
社群
86
安全
83
規範符合性

你能建構什麼

Запуск оформления заказа для разового продукта

Создать серверный поток оформления заказа для цифрового продукта с выполнением на основе метаданных.

Маршрутизация пользовательских событий веб-хуков

Добавить маршрутизацию на основе метаданных для разделения пользовательских покупок от планов или кредитных потоков.

Масштабирование выполнения с помощью фоновых заданий

Перенести медленное выполнение в Inngest, чтобы избежать тайм-аутов веб-хуков и обеспечить идемпотентную обработку.

試試這些提示

Базовая сессия оформления заказа
Создать серверную сессию оформления заказа Stripe для разового продукта за $49. Включить тип метаданных и productId.
Логика маршрутизации веб-хуков
Объяснить, как маршрутизировать события checkout.session.completed с использованием metadata.type и где разместить логику.
План фоновой обработки
Разработать рабочий процесс Inngest для выполнения платежей с проверками идемпотентности и шагом отправки подтверждающего письма.
Контрольный список настройки окружения
Перечислить переменные окружения Stripe, необходимые для сервера, клиента и проверки веб-хуков, и описать, где они используются.

最佳實務

  • Используйте metadata.type для разделения пользовательских продуктов от планов и кредитных потоков.
  • Быстро отвечайте на веб-хуки и перекладывайте медленную работу на Inngest.
  • Добавляйте проверки идемпотентности перед созданием заказов или предоставлением доступа.

避免

  • Использование только идентификаторов продуктов для маршрутизации, когда доступны метаданные.
  • Выполнение длительных обновлений базы данных непосредственно внутри обработчика веб-хука.
  • Пропуск проверки подписи веб-хука с помощью STRIPE_WEBHOOK_SECRET.

常見問題

Когда следует использовать stripe-handler?
Используйте его для разовых продуктов или пользовательских сервисов, которые не являются стандартными планами или кредитными пакетами.
Создает ли этот навык продукты Stripe для меня?
Нет. Он фокусируется на логике оформления заказа, веб-хуков и выполнения, а не на управлении продуктами в Stripe.
Как предотвратить дублирование выполнения?
Сохраните идентификатор сессии Stripe и проверьте существующий заказ перед выполнением.
Какие переменные окружения требуются?
Вам нужны STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET и NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY.
Можно ли использовать его с подписками?
Да, но он оптимизирован для пользовательских потоков. Используйте plans-handler для стандартных подписочных планов.
Обязателен ли Inngest?
Нет. Он рекомендуется для длительного выполнения и событий с большим объемом.

開發者詳情

檔案結構