Интеграция Cryptomus: API, вебхуки и типовые сценарии
Этот раздел сделан под разработчиков и продуктовых менеджеров: как правильно встроить оплату, какие
события ловить, как организовать статусы и что протестировать до запуска.
Payment API
Создание инвойсов, получение статусов, управление оплатами.
- Создать счёт
- Проверить статус
- Сохранить метаданные заказа
Payout API
Автоматизация выводов и массовых выплат под ваши процессы.
- Одиночный вывод
- Массовые выплаты
- Конвертация на выводе
Webhooks
События о платежах: меняйте статус заказа автоматически.
- Paid / Partially paid
- Expired
- Переотправка/логирование
Рекомендованный flow внедрения
- Договоритесь о модели оплаты: инвойс в фиате или в крипте, какие сети поддерживаете.
- Создайте merchant и подготовьте ключи: Payment API и Payout API (при необходимости).
- Сделайте “order_id → invoice_id” mapping, храните суммы и валюты, фиксируйте тайм-аут.
- Подключите вебхуки и обработайте события: Paid/Partial/Expired.
- Протестируйте крайние случаи: недоплата/переплата, повторная оплата, отмена.
- Добавьте наблюдаемость: логи, ретраи, алерты по ошибкам подписи/тайм-аутам.
Чек-лист перед запуском
- Страница оплаты открывается быстро и корректно на мобайле
- Вебхуки принимаются и валидируются
- Заказ меняет статус только после “Paid”
- Выплаты/выводы ограничены правилами безопасности
- Служба поддержки знает, где смотреть логи и статусы
Готовые плагины
Для быстрых интеграций используйте готовые решения для CMS и магазинов — это снижает время внедрения
и риск ошибок в обработке статусов.