stripe-best-practices · openai — скилл для Codex: что делает и как установить
Рекомендации по интеграции Stripe для Codex: выбор API, настройка подписок, налогов и безопасность ключей.
npx skills add openai/plugins --skill stripe-best-practices -a codexЧто делает stripe-best-practices
Скилл задаёт правила интеграции Stripe для ИИ-ассистента. Он направляет выбор API: рекомендует Checkout Sessions для разовых оплат и подписок, Accounts v2 для маркетплейсов и Metronome для тарификации по объёму использования. Инструкции требуют вызывать методы через экземпляр StripeClient, запрещая устаревшие глобальные настройки вроде stripe.api_key.
Набор правил закрывает частые ошибки при разработке. Например, запрещает передавать payment_method_types вручную (кроме терминалов с card_present), чтобы работали динамические методы оплаты. Перед включением automatic_tax скилл требует подтвердить регистрацию в Registrations API, иначе начисление налога не сработает. Для авторизации задаётся стандарт restricted API keys (rk_).
Тестировать вызовы можно без регистрации через stripe sandbox create в Stripe CLI. Скилл стоит ставить разработчикам, которые проектируют приём платежей с нуля или переносят код на свежие версии SDK.
Какие задачи решает
- выбрать подходящий API под разовые платежи или подписки
- настроить расчёт налогов через Stripe Tax без пропуска регистраций
- перейти с глобального
stripe.api_keyна экземплярыStripeClient - создать тестовую среду без регистрации через
stripe sandbox create
Примеры запросов агенту
- Помоги настроить Checkout Sessions для разовой оплаты на Node.js.
- Как безопасно подключить Stripe Tax для сбора VAT?
- Создай аккаунт мерчанта через Connect Accounts v2 на Python.
Как установить stripe-best-practices
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill stripe-best-practices -a codex2Вручную: положить файлы
.agents/skills/stripe-best-practices/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill stripe-best-practices -a claude-code2Вручную: положить файлы
~/.claude/skills/stripe-best-practices/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/stripe-best-practices/
Вручную: положить файлы
.cursor/skills/stripe-best-practices/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install openai/plugins stripe-best-practices2Вручную: положить файлы
.github/skills/stripe-best-practices/SKILL.mdКомандой платформы
gemini skills install https://github.com/openai/plugins --path plugins/stripe/skills/stripe-best-practicesВручную: положить файлы
.devin/skills/stripe-best-practices/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
Из того же набора201
Весь набор →Другие версии stripe-best-practices
Похожие
Вопросы о stripe-best-practices
Как установить stripe-best-practices в Codex?
Выполните команду npx skills add openai/plugins --skill stripe-best-practices в терминале. Файл сохранится в .agents/skills/stripe-best-practices/SKILL.md.
Зачем нужен скилл stripe-best-practices?
Он направляет агента на актуальные паттерны Stripe API версии 2026-07-29.dahlia. Скилл предотвращает типичные ошибки с налогами и устаревшими методами передачи ключей.
Почему скилл запрещает параметр payment_method_types?
Ручное перечисление отключает динамический показ доступных методов оплаты из панели Stripe. Исключение сделано только для платежей через терминал с параметром card_present.