Тестирование интеграции

#Чек-лист перед запуском

1. 1

   Проверьте авторизацию

   Вызовите GET /me — в ответе должно прийти название вашего магазина.

2. 2

   Отправьте тестовый вебхук

   В настройках магазина нажмите кнопку отправки тестового вебхука. На ваш URL придёт событие webhook.test с корректной подписью.

3. 3

   Создайте счёт

   Создайте счёт через API и откройте pay_url в браузере — убедитесь, что видите нужные монеты и сумму.

4. 4

   Проведите небольшой платёж

   Оплатите счёт на минимальную сумму в сети с низкой комиссией: USDT (TRC-20), TON, USDT в TON или Polygon.

5. 5

   Проверьте выдачу товара

   Убедитесь, что пришли события invoice.pending, invoice.confirming и invoice.paid, а заказ отмечен оплаченным ровно один раз.

#Проверка ключа

curl "https://app.ketmus.com/api/merchant/v1/me" \
  -H "Authorization: Bearer $KETMUS_API_KEY"

#Вебхуки на локальной машине

Ketmus отправляет уведомления только на публичные адреса. Для разработки откройте локальный сервер через туннель (например, ngrok http 3000 или cloudflared tunnel) и укажите полученный HTTPS-адрес в callback_url.

#Минимальные суммы

У каждой сети есть минимальная сумма счёта, чтобы перевод не съела комиссия сети. Например, для BTC это 5 USD, для ETH и USDT в Ethereum — 10 USD, для большинства остальных сетей — 1–2 USD. Полный список — в разделе Поддерживаемые монеты.