kryptogo-pay: Скилл для интеграции криптовалютных платежей

```markdown --- name: kryptogo-pay description: > Предоставляет обзор интеграции KryptoGO Payment и направляет пользователей к соответствующим функциям. Используйте, когда начинаете интеграцию платежей KryptoGO, настраиваете среду или нуждаетесь в общих рекомендациях по стабильным платежам KryptoGO. argument-hint: "[Функция: checkout/query/webhook/transfer]" user-invocable: true --- # Руководство по интеграции платежей KryptoGO со стабильными монетами Ваша задача - помочь пользователям настроить среду KryptoGO Payment и направить их к соответствующим функциям. ## Анализ потребностей пользователя Ввод пользователя: `$ARGUMENTS` В зависимости от потребностей пользователя, определите следующий шаг: - Если содержит "получение платежа", "checkout", "создание платежа", "payment intent" → Направьте пользователя к `/kryptogo-pay-checkout` - Если содержит "запрос", "query", "статус заказа" → Направьте пользователя к `/kryptogo-pay-query` - Если содержит "webhook", "callback", "уведомление" → Направьте пользователя к `/kryptogo-pay-webhook` - Если содержит "вывод", "перевод", "transfer", "withdrawal" → Направьте пользователя к `/kryptogo-pay-transfer` - Если не указано конкретное действие → Предоставьте следующие рекомендации по настройке среды ## Проверка настроек среды Задайте пользователю следующие вопросы: 1. **Способ интеграции**: Как вы планируете интегрировать KryptoGO Payment? - React SDK (фронтенд `@kryptogo/kryptogokit-sdk-react`) - Direct API (бэкенд напрямую вызывает REST API) - Оба (фронтенд SDK + бэкенд API) 2. **Состояние среды**: Есть ли у вас аккаунт KryptoGO Studio? - Да, у меня есть Client ID и API Key - Нет, мне нужно зарегистрироваться ## Настройка переменных среды Помогите пользователю создать переменные среды: ```bash # Для интеграции через API бэкенда KRYPTOGO_CLIENT_ID=your_client_id KRYPTOGO_STUDIO_API_KEY=your_studio_api_key KRYPTOGO_ORIGIN=your_domain ``` **Инструкции для пользователя:** 1. Перейдите на [KryptoGO Studio](https://studio.kryptogo.com) и зарегистрируйте аккаунт. 2. Создайте API Key в разделе Account Settings (отображается только один раз, пожалуйста, сохраните его). 3. Создайте или отредактируйте файл `.env` в корне проекта. 4. Добавьте вышеуказанные переменные среды. 5. Убедитесь, что файл `.env` добавлен в `.gitignore`. ## Быстрый старт (Пример сервера Express) Если пользователь хочет быстро начать: ```bash npx create-kg-express-test my-app cd my-app cp .env.example .env # Отредактируйте .env и вставьте STUDIO_API_KEY, CLIENT_ID, ORIGIN npm install && npm start ``` ## Следующий шаг После настройки среды, направьте пользователя в зависимости от его потребностей: | Требование | Skill | Описание | |------|-------|------| | Создание платежа для получения | `/kryptogo-pay-checkout` | Создание Payment Intent для получения стабильных монет | | Запрос статуса транзакции | `/kryptogo-pay-query` | Запрос статуса одной или нескольких Payment Intent | | Обработка Webhook callback | `/kryptogo-pay-webhook` | Получение уведомлений об изменении статуса платежа | | Вывод/Перевод | `/kryptogo-pay-transfer` | Перевод стабильных монет на внешний кошелек | ## Информация об API | Элемент | Описание | |------|------| | Base URL | `https://wallet.kryptogo.app` | | Документация API | `https://www.kryptogo.com/docs/api/payment` | | Studio | `https://studio.kryptogo.com` | | Поддерживаемые токены | USDT, USDC (Arbitrum) | | Поддерживаемые фиатные валюты | TWD, USD | | Комиссия | 1% фиксированная комиссия | | Обновление статуса | В течение 8 секунд (кроме ETH) | | Минимальная сумма | fiat_amount >= 0.01 | ## Поддерживаемые способы оплаты - **KryptoGO Wallet** (рекомендуется): Оплата с помощью QR-кода. - **MetaMask / WalletConnect**: Подключение через браузерный кошелек или WalletConnect. - **Перевод по QR-коду**: Ручной перевод с биржи или другого кошелька. ## Два пути интеграции ### 1. Интеграция React SDK (фронтенд) Подходит для: сценариев, где требуется UI для оплаты на стороне клиента. ```bash npm install @kryptogo/kryptogokit-sdk-react wagmi viem@2.x @tanstack/react-query ``` ### 2. Интеграция Direct API (бэкенд) Подходит для: чисто серверных сервисов, пользовательских фронтендов, интеграции на разных платформах. Обязательные заголовки: - `X-Client-ID`: Ваш Client ID - `X-STUDIO-API-KEY`: Ваш Studio API Key - `Origin`: Ваш домен ## Важные замечания 1. API Key должен быть конфиденциальным и не должен быть виден в коде на стороне клиента. 2. Все вызовы API должны выполняться с бэкенда (для защиты учетных данных). 3. В настоящее время поддерживается сеть Arbitrum для USDT/USDC. 4. Срок действия Payment Intent составляет 30 минут. 5. Эндпоинт обратного вызова должен отвечать HTTP 200 для подтверждения получения. ```