view --main kryptogo-pay-skill-dlya-integratsii-kriptovalyutnyh-platezhey.md
kryptogo-pay: Скилл для интеграции криптовалютных платежей
SKILL.md
readonly
--- lines
```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 для подтверждения получения.
```
Инициализация мануала...
package.json
$ install --global
skills.sh
npx skills add https://github.com/paid-tw/skills/tree/main/plugins/kryptogo-pay/skills/kryptogo-pay
$ download --local
man
[HINT] Скачивает всю директорию скилла с GitHub: SKILL.md и все связанные файлы