newebpay: Скилл для интеграции и обзора

```markdown --- name: newebpay description: > Предоставляет обзор интеграции NewebPay и направляет пользователей к соответствующему функционалу. Используйте, когда начинаете интеграцию NewebPay, настраиваете окружение или нуждаетесь в общих рекомендациях по работе с платежной системой 藍新金流. argument-hint: "[Функция: checkout/query/refund]" user-invocable: true --- # Руководство по интеграции 藍新金流 Ваша задача - помочь пользователям настроить окружение 藍新金流 (NewebPay) и направить их к соответствующим функциям. ## Анализ потребностей пользователя Пользователь вводит: `$ARGUMENTS` В зависимости от потребностей пользователя, определите следующий шаг: - Если содержатся слова "интеграция", "checkout", "создание транзакции", "MPG" → Направьте пользователя к `/newebpay-checkout` - Если содержатся слова "запрос", "query", "статус заказа" → Направьте пользователя к `/newebpay-query` - Если содержатся слова "возврат", "refund", "отмена" → Направьте пользователя к `/newebpay-refund` - Если нет конкретных указаний → Предоставьте следующие инструкции по настройке окружения. ## Проверка настроек окружения Задайте пользователю следующие вопросы: 1. **Фреймворк**: Какой фреймворк вы используете? - PHP (Laravel / Native PHP / Другое) - Node.js (Express / NestJS / Native / Другое) - Python (Django / Flask / FastAPI / Другое) - Другое 2. **Состояние окружения**: Есть ли у вас аккаунт NewebPay? - Да, есть тестовый аккаунт - Да, есть рабочий аккаунт - Нет, требуется регистрация ## Настройка переменных окружения Направьте пользователя на создание переменных окружения: ```bash NEWEBPAY_MERCHANT_ID=MS12345678 NEWEBPAY_HASH_KEY=your_hash_key NEWEBPAY_HASH_IV=your_hash_iv NEWEBPAY_ENV=test # test или production ``` **Инструкции для пользователя:** 1. Создайте или отредактируйте файл `.env` в корневой директории проекта. 2. Добавьте указанные переменные окружения. 3. Убедитесь, что файл `.env` добавлен в `.gitignore`. ## Следующий шаг После завершения настройки окружения, направьте пользователя в зависимости от его потребностей: | Потребность | Skill | Описание | |------|-------|------| | Создание страницы оплаты | `/newebpay-checkout` | Интеграция MPG (front-end) | | Запрос статуса транзакции | `/newebpay-query` | API для запроса статуса транзакции | | Обработка возврата | `/newebpay-refund` | Возврат средств с кредитной карты/электронного кошелька | ## Информация об окружении | Окружение | API Base URL | |------|--------------| | Тестовое | `https://ccore.newebpay.com` | | Рабочее | `https://core.newebpay.com` | ## Поддерживаемые способы оплаты - **Кредитные карты**: Единовременная оплата, оплата в рассрочку, скидка по бонусным баллам - **Мобильные платежи**: Apple Pay, Google Pay, Samsung Pay - **Электронные кошельки**: LINE Pay, TaiwanPay, TWQR - **Банкоматы**: WebATM, перевод с банкомата - **Магазины**: Оплата по коду, оплата по штрих-коду ## Важные замечания 1. `HashKey` и `HashIV` должны храниться в секрете и не должны быть доступны на стороне клиента. 2. Допустимая погрешность для временной метки ±120 секунд. 3. Номер заказа не должен повторяться, максимальная длина - 30 символов. 4. `ReturnURL` и `NotifyURL` принимают только порты 80/443. ```