Работа с платежами в QryptoPay
У каждого платежа в QryptoPay есть своя карточка — диалог «Данные о платеже в блокчейне». Откройте мерчанта, перейдите на вкладку «Платежи», наведите на нужную строку и нажмите иконку с подсказкой «Данные о платеже».
На вкладке есть поиск — по адресу электронной почты клиента (по совпадению части адреса) или по точному ID платежа — и фильтры по статусу оплаты, валюте и сети. Статус рядом с платежом показывает его этап: «Создан» и «Не оплачен» — деньги ещё не поступили, «Частично оплачен» и «Переплата» — сумма отличается от ожидаемой, «Оплачен» — платёж закрыт, «Просрочен» — истёк срок, «Аннулирован» — платёж закрыт без оплаты.
Данные о платеже в блокчейне
По платежу видны найденные транзакции, и ссылка «Смотреть в обозревателе» у каждой открывает блокчейн-обозреватель.
⚠️ Перепроверка и поиск по хешу — только для Tron и Ethereum
Кнопки «Перепроверить платёж» и «Проверить транзакцию по ID» появляются в карточке только для платежей в сетях Tron и Ethereum — то есть TRX, USDT TRC-20 и другие токены Tron, а также ETH, USDT ERC-20, USDC и другие токены Ethereum. Для Bitcoin, Litecoin и Monero таких кнопок в карточке нет — ручных инструментов на этот случай не предусмотрено.
Доставка вебхука
Как только платёж оплачен, в карточке появляется блок «Доставка вебхука» — он показывает, дошло ли до вашего магазина уведомление о статусе именно этого платежа. Возможные состояния:
- Доставлено — уведомление получено магазином.
- Отправляется… — отправка уже идёт прямо сейчас.
- Ожидает повтора — предыдущая попытка не удалась, повтор поставлен в очередь и выполняется автоматически.
- Не доставлено — доставить не удалось, и автоматических попыток больше не будет.
- Не отправлялось — уведомление ещё ни разу не пытались отправить.
Сценарий 1. Платёж оплачен, но панель его не фиксирует
Клиент говорит, что перевёл деньги, а платёж всё ещё не оплачен. Для Tron и Ethereum есть два инструмента, по возрастанию усилий.
Сначала нажмите «Перепроверить платёж». Панель заново просканирует блоки за весь срок жизни платежа, разыскивая переводы на его адрес в обход обычного сканера. Результат приходит уведомлением: нашёлся — панель зачислит его и обновит статус платежа; не нашёлся — для уже оплаченного это значит «уже учтено», для остальных остаётся проверка по хешу транзакции. Не более трёх перепроверок одного платежа в час.
Если перепроверка не помогла или клиент готов прислать хеш перевода — нажмите «Проверить транзакцию по ID», вставьте хеш в поле «ID транзакции» и нажмите «Проверить» — это разовая проверка, она ничего не меняет в платеже. Если перевод относится именно к этому платежу, появится кнопка «Провести». Другие ответы разобраны в сценарии «Деньги пришли не туда» ниже. Не более десяти проверок в час на терминал.
Сценарий 2. Панель фиксирует платёж, а магазин не получил уведомление
Платёж оплачен, но магазин не отреагировал: заказ не закрылся. Причина — в блоке «Доставка вебхука», который появляется только у уже оплаченных платежей.
Уведомления о статусе панель отправляет автоматически, как только платёж закрывается, а если первая попытка не удалась — повторяет отправку раз в час, пока не получит от магазина ответ 200 OK. Кнопка «Отправить повторно» нужна, когда ждать нежелательно или автоматические попытки уже закончились:
- при статусе «Ожидает повтора» — панель отправит уведомление сразу, не дожидаясь автоматической попытки;
- при статусе «Не доставлено» — автоматических попыток больше нет, и это единственный способ повторить отправку;
- при статусе «Не отправлялось» — уведомление будет отправлено впервые.
Если в настройках терминала не указан вебхук, кнопки нет — вместо неё в карточке появляется подсказка заполнить вебхук (это делается на шаге настройки вебхука при интеграции магазина).
⚠️ Повторная отправка уже доставленного уведомления рискованна
Для статуса «Доставлено» панель отдельно предупреждает: магазин уже получил уведомление раньше, и повторная отправка может привести к двойному зачислению платежа на его стороне. Отправляйте повторно, только если точно знаете, что магазин это уведомление не обработал.
⚠️ У «Не отправлялось» есть два разных случая
Если уведомление уже было сформировано, но не ушло, панель отправит именно его — без изменений. Но если уведомление ещё не было сформировано, панель соберёт его заново по текущим данным платежа — оно может отличаться от того, что получил бы магазин изначально.
Кнопка «Отправить повторно» тоже ограничена — не более пяти отправок одного платежа в час.
Сценарий 3. Деньги пришли не туда
Клиент прислал хеш перевода, но платёж, который вы открыли, не про него: перевод пришёл на адрес клиента, но привязался к другому платежу или ни к одному. Панель обычно выделяет клиенту один и тот же адрес на все его платежи и ищет перевод по адресу, а не по конкретному счёту — поэтому подойдёт любой платёж этого клиента, не обязательно «тот самый».
Откройте карточку такого платежа, нажмите «Проверить транзакцию по ID», вставьте хеш в поле «ID транзакции» и нажмите «Проверить». Дальше возможны варианты:
- Перевод относится к другому платежу — открывается карточка этого платежа с кнопкой «Провести в этот платёж»: она зачислит перевод туда, а не в открытый вами платёж.
- Подходящего платежа нет — на этот адрес переводили, когда ни один счёт не был активен. Кнопка «Оформить как пополнение» создаст для перевода отдельный, уже оплаченный платёж, чтобы деньги не потерялись, и отправит магазину уведомление о нём.
- Перевод уже был проведён раньше — карточка показывает, к какому платежу он относится, действий не потребуется.
Другие ответы — ошибка ноды блокчейна, лицензионное ограничение и подобное — поясняются прямо в диалоге; тогда остаётся только попробовать позже.
Полезные ссылки
- Интеграция магазина с QryptoPay — как магазин получает и проверяет уведомления по вебхуку.
- Маршрутизация платежей по кошелькам в QryptoPay — если платежи одного клиента постоянно путаются между кошельками, проверьте правила маршрутизации.
- Журнал операций в QryptoPay — если найденный хеш относится не к платежу клиента, а к переводу между вашими собственными кошельками, импорт по хешу — там, на вкладке «Операции».