← EventKit

Подключение PayPal и Gemini

Ключи добавляются в файл .env в папке проекта. Не отправляйте секреты в чат и не загружайте этот файл на GitHub.

1. PayPal Sandbox

  1. Откройте PayPal Developer Dashboard и войдите.
  2. Выберите Apps & Credentials → Sandbox.
  3. Откройте Default Application или Create App, название EventKit. Для приложения выберите тестовый аккаунт продавца Business.
  4. Скопируйте Client ID в PAYPAL_CLIENT_ID, Secret — в PAYPAL_CLIENT_SECRET.
  5. В Testing Tools → Sandbox Accounts откройте аккаунт Personal через ⋮ → View/Edit Account. Сохраните email и пароль для тестовой покупки. Платить нужно с аккаунта покупателя, а не продавца.

Приложение использует только api-m.sandbox.paypal.com. Реальные деньги не перемещаются. Официальная инструкция.

2. Google Gemini

  1. Откройте Google AI Studio → API keys, войдите и примите условия.
  2. Для нового пользователя может быть автоматически создан проект и ключ. Используйте этот ключ либо нажмите Create API key.
  3. Выберите или создайте проект. Если имеющийся проект отсутствует: Dashboard → Projects → Import projects.
  4. Скопируйте ключ в GEMINI_API_KEY.

Бесплатная квота зависит от проекта и модели. При ошибке квоты проверьте Usage / Billing. Модель можно изменить в GEMINI_MODEL на доступную вашему проекту модель Gemini с generateContent и structured output. Официальная инструкция.

3. Файл .env

PORT=3000
PAYPAL_CLIENT_ID=ваш_sandbox_client_id
PAYPAL_CLIENT_SECRET=ваш_sandbox_secret
GEMINI_API_KEY=ваш_ключ_gemini
GEMINI_MODEL=gemini-3.5-flash-lite

Замените значения после =, сохраните файл. Если сервер уже запущен, остановите его через Ctrl+C и снова запустите START.cmd или npm start. Обновите EventKit.

Проверка: Build my kit должен вернуть новый AI-план; затем Review & checkout → подтвердить состав → PayPal → вход с тестовым Personal аккаунтом → Pay now. Успех подтверждается идентификатором capture, а не только закрытием окна PayPal.

Пример комплекта работает без ключей и явно помечен как preset. Он не заменяет AI-вызов для хакатона.