architect/_archive/2025-12-03_stripe-example/infrastructure/CONNECTION.md

Connection: Stripe API (Example)

API Endpoint: https://api.stripe.com/v1/
Тип: REST API
Дата создания: 2025-11-13

⚠️ ВНИМАНИЕ: Это пример проекта с фиктивными ключами!


API Access

Publishable Key (Test):

pk_test_EXAMPLE_KEY_NOT_REAL

Secret Key (Test):

sk_test_EXAMPLE_KEY_NOT_REAL

⚠️ В РЕАЛЬНОМ ПРОЕКТЕ:
- Никогда не храните ключи в git!
- Используйте переменные окружения
- Добавьте CONNECTION.md в .gitignore


Quick Test

# Проверка API доступа
curl https://api.stripe.com/v1/charges \
  -u sk_test_YOUR_REAL_KEY:

# Ожидается: список платежей или ошибка 401 (если ключ неверный)

Dashboard Access

URL: https://dashboard.stripe.com/
Login: your-email@example.com
2FA: Рекомендуется включить

Разделы:
- Payments - история платежей
- Customers - база клиентов
- Developers → API keys - ключи доступа
- Developers → Webhooks - настройка вебхуков


Webhooks

Endpoint URL: https://your-domain.com/webhooks/stripe
Webhook Secret: whsec_EXAMPLE_SECRET_NOT_REAL

События для прослушивания:
- payment_intent.succeeded
- payment_intent.failed
- customer.subscription.created
- customer.subscription.updated
- customer.subscription.deleted

Тест вебхука:

stripe trigger payment_intent.succeeded

Rate Limits

Test Mode:
- 25 requests/second
- Без ограничений по количеству

Live Mode:
- 100 requests/second (Standard)
- Можно увеличить по запросу

Мониторинг:
- Dashboard → Developers → Logs
- Каждый запрос записывается


Environment Variables

# .env файл
STRIPE_PUBLISHABLE_KEY=pk_test_...
STRIPE_SECRET_KEY=sk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...

Никогда не коммитить .env в git!

# .gitignore
.env
**/CONNECTION.md
**/CREDENTIALS.md

Обновлено: 2025-11-13