Как расследовать пропавший криптоплатеж

Клиент говорит, что оплатил заказ, но заказ по-прежнему отображается как неоплаченный. Кошелек может показывать транзакцию как отправленную, тогда как мерчант не находит ее в ожидаемой записи о платеже. Прежде чем просить клиента заплатить повторно или считать средства потерянными, бизнесу необходимо провести структурированное расследование. В этом руководстве объясняется, как проследить пропавший криптоплатеж от исходного заказа и идентификатора транзакции до блокчейна, платежного шлюза и итоговой записи мерчанта.

Что на самом деле означает «пропавший криптоплатеж»?

Пропавший криптоплатеж не всегда означает, что транзакция исчезла.

На практике это выражение может описывать несколько разных ситуаций:

• клиент создал транзакцию, но она еще не попала в сеть;
• транзакция существует, но все еще находится в ожидании;
• клиент отправил платеж через неправильную блокчейн-сеть;
• адрес назначения или токен указаны неверно;
• клиент отправил сумму меньше требуемой;
• инвойс истек до того, как клиент завершил оплату;
• OxaPay обнаружил платеж, но система мерчанта не обновила заказ;
• платеж существует, но мерчант не может сопоставить его с нужным клиентом или заказом.

Эти случаи требуют разных действий. Поэтому первая задача — не просто «найти деньги», а определить, на каком этапе платеж перестал соответствовать ожидаемому процессу.

Более широкий жизненный цикл криптоплатежа показывает, что обнаружение транзакции, принятие платежа, выполнение заказа и операционное завершение — это отдельные этапы. Платеж может быть виден в блокчейне, но еще не привести к ожидаемому бизнес-результату.

Перед началом: не просите клиента платить повторно

Второй платеж может превратить простое расследование в проблему дублирующего платежа и возврата.

Пока первая транзакция не найдена и не классифицирована, служба поддержки не должна просить клиента отправлять средства повторно. Также нельзя запрашивать у клиента:

• приватный ключ;
• seed-фразу или фразу восстановления;
• пароль от кошелька;
• код аутентификации.

Для расследования нужны только платежные идентификаторы и публично проверяемая информация о транзакции.

Расследование пропавшего криптоплатежа: пошагово

Шаг 1. Соберите платежные идентификаторы

Начните с собственных записей мерчанта, а не с немедленного поиска в блокчейне.

Запросите или получите:

Когда мерчанты создают инвойс OxaPay, они могут указать собственный order_id. OxaPay также предоставляет track_id, который затем можно использовать для получения связанной записи Payment Information.

Сочетание Order ID, track ID и TXID дает три разных представления:

• Order ID: что клиент пытался приобрести;
• Track ID: как платежный шлюз представляет платеж;
• TXID: что произошло в блокчейне.

Статья OxaPay Объяснение идентификатора криптотранзакции простым для клиента языком объясняет, как найти и использовать TXID для отслеживания перевода.

Шаг 2. Убедитесь, что TXID действителен

Скриншот кошелька со статусом «отправлено» не доказывает, что кошелек успешно передал транзакцию в сеть.

Скопируйте TXID напрямую и найдите его через обозреватель блоков той сети, которую, по словам клиента, он использовал.

Проверьте:

• распознает ли обозреватель TXID;
• относится ли транзакция к ожидаемому блокчейну;
• имеет ли транзакция статус в ожидании, подтверждена, неуспешнаили остается нерешенной;
• соответствует ли время отправки попытке оплаты.

Сети вроде Ethereum создают хеш транзакции, когда пользователь отправляет транзакцию. Затем сеть распространяет транзакцию и ожидает ее включения в блок. Транзакции Bitcoin аналогично получают подтверждения после того, как майнеры включают их в блоки.

Если TXID не удается найти

Возможные причины:

• TXID скопирован неверно;
• клиент ищет в неправильной сети;
• кошелек создал транзакцию локально, но не передал ее в сеть;
• кошелек показывает внутренний идентификатор вместо блокчейн-TXID;
• транзакция так и не была успешно отправлена.

Попросите клиента открыть детали транзакции в кошельке и подтвердить точную сеть и TXID.

Не отмечайте заказ как оплаченный, если проверяемую транзакцию найти не удалось.

Шаг 3. Проверьте сеть, актив, адрес и сумму

Найти транзакцию — только начало. Она должна соответствовать платежному запросу.

Сравните четыре параметра.

Сеть

Убедитесь, что платеж был отправлен через сеть, выбранную при оформлении оплаты.

Это особенно важно для активов вроде USDT и USDC, которые могут существовать в нескольких сетях. Транзакция, совершенная в одной сети, не появится при поиске в другой.

Актив

Убедитесь, что клиент отправил ожидаемую криптовалюту или токен-контракт.

Одинаковый формат адреса иногда может использоваться в совместимых сетях, но это не означает поддержку любого токена или сетевого маршрута.

Адрес назначения

Сравните адрес получателя в блокчейн-транзакции с адресом, показанным в платежном запросе.

Подтвержденная транзакция, отправленная на другой адрес, не пропала из блокчейна. Она была отправлена по другому маршруту.

Сумма

Сравните полученную сумму с запрошенной.

Клиент мог:

• ввести неверную сумму;
• оплатить только часть инвойса;
• неправильно понять, какие комиссии взимаются отдельно от суммы платежа;
• отправить несколько небольших транзакций вместо одного полного платежа.

Профессиональный платежный шлюз оценивает сеть, адрес назначения, токен, сумму, время и подтверждающие данные, прежде чем классифицировать перевод как действительный платеж.

Шаг 4. Определите состояние транзакции в блокчейне

Если транзакция существует и платежные данные верны, определите, достигла ли она стадии, достаточной для принятия.

В ожидании или не подтверждена

Сеть уже видит транзакцию, но она еще не достигла необходимого уровня подтверждения или финальности.

В этом случае:

• не просите клиента отправлять средства повторно;
• объясните, что транзакция найдена;
• сообщите клиенту четкий срок следующей проверки;
• продолжайте проверку в соответствии с платежной политикой мерчанта.

Время подтверждения зависит от сети и текущих условий. Видимость транзакции и финальность платежа не следует считать одним и тем же событием.

Подтверждена

Подтвержденная транзакция доказывает, что сеть обработала перевод. Но она не доказывает автоматически, что платеж удовлетворил условия инвойса мерчанта.

Адрес, актив, сумма, сеть, время действия инвойса и связанная платежная запись по-прежнему должны совпадать.

Неуспешна или завершилась с ошибкой

Если обозреватель показывает, что транзакция завершилась неуспешно, платеж не был выполнен как предполагалось.

Служба поддержки должна объяснить проверенный результат и попросить клиента проверить кошелек перед новой попыткой оплаты. Мерчант не должен отмечать заказ как оплаченный только на основании попытки перевода.

Шаг 5. Проверьте платежную запись OxaPay

После того как данные блокчейна понятны, проверьте запись OxaPay с помощью track ID.

В OxaPay Payment Information в OxaPay как endpoint предоставляет подробную информацию о конкретном платеже. Payment History также можно фильтровать по track ID, статусу, типу платежа, активу, сети, сумме, адресу и диапазону дат.

Сравните:

• статус OxaPay;
• ожидаемую и полученную сумму;
• валюту платежа;
• сеть;
• информацию о транзакции;
• время действия инвойса;
• ссылку на заказ мерчанта.

OxaPay документирует статусы платежей , включая:

• new;
• waiting;
• paying;
• paid;
• manual_accept;
• underpaid;
• refunding;
• refunded;
• expired.

Что может означать статус

Если OxaPay показывает paid, а заказ клиента остается неоплаченным, расследование уже не относится к блокчейну. Вероятная проблема находится в обновлении заказа, интеграции или процессе выполнения со стороны мерчанта.

Шаг 6. Сравните платеж с заказом мерчанта

Проверьте, связана ли платежная запись OxaPay с правильным внутренним заказом.

Проверьте:

• сохраненный Order ID;
• сохраненный track ID;
• ожидаемую сумму;
• клиента или аккаунт;
• статус заказа;
• статус выполнения или зачисления на аккаунт;
• любые ручные изменения или предыдущие действия поддержки.

На этом этапе обычно выявляется один из трех результатов.

Платеж корректен, но заказ не обновился

Платеж на самом деле не пропал. Система мерчанта не смогла преобразовать платежный статус в ожидаемое бизнес-действие.

Если интеграция использует callbacks, проверьте настройку Webhook OxaPay и путь доставки, прежде чем считать проблему связанной с блокчейном.

Передайте случай в Payment Operations или Engineering вместе с полными идентификаторами и текущими статусами.

Платеж был привязан к неправильному заказу

Не переносите платеж незаметно без фиксации решения.

Подтвердите правильного клиента и заказ, исправьте связь по утвержденному процессу и сохраните аудиторский след.

Ни один заказ нельзя сопоставить с уверенностью

Поместите платеж в очередь исключений. Используйте сумму, время, адрес, данные клиента и TXID как подтверждающую информацию, но не делайте предположений, если доступные данные могут соответствовать нескольким заказам.

Подробный процесс сопоставления будет рассмотрен в материале How to Match Orders, Track IDs, and Blockchain Transactions.

Шаг 7. Классифицируйте первопричину

В конце расследования случай должен иметь четкую классификацию.

OxaPay предоставляет конкретные варианты для недоплаченных и просроченных инвойсов, включая проверку мерчантом, принятие, продление или возврат в зависимости от сценария и текущего поведения продукта. Как OxaPay обрабатывает недоплаченные и просроченные инвойсы подробно объясняет эти случаи.

Когда следует передать случай в OxaPay?

Передавайте случай на расследование со стороны провайдера, если:

• блокчейн-транзакция соответствует ожидаемому адресу, сети, активу, сумме и времени, но соответствующий платеж OxaPay отсутствует;
• Payment Information и Payment History показывают противоречивые результаты;
• статус платежа не соответствует имеющимся данным о транзакции;
• возврат или ручное платежное действие остается незавершенным;
• мерчант не может объяснить запись на стороне провайдера с помощью доступной документации.

Предоставьте полный набор данных:

• ссылку Merchant API или аккаунта, если применимо;
• track ID;
• order ID;
• TXID;
• актив и сеть;
• ожидаемую и полученную сумму;
• время платежа;
• текущий статус OxaPay;
• данные обозревателя блокчейна;
• статус заказа мерчанта;
• краткое описание несоответствия.

Полная эскалация сокращает повторные вопросы и помогает отделить расследование на стороне провайдера от проблем клиента, кошелька или интеграции мерчанта.

Как предотвращать случаи пропавших платежей

Многие расследования пропавших платежей начинаются со слабых идентификаторов или неясных инструкций для клиентов.

Мерчанты могут снизить количество таких случаев, если будут:

• сохранять order ID и track ID при создании платежа;
• четко отображать актив, сеть, сумму и крайний срок оплаты;
• сохранять платежные записи после checkout;
• показывать клиентам понятные статусы платежа;
• контролировать заказы со статусом paid, которые еще не выполнены;
• вести единую общую очередь исключений;
• тестировать сценарии задержки, недоплаты, истечения срока и неуспешных платежей;
• обучать поддержку запрашивать правильные подтверждения.

В OxaPay Generate Invoice endpoint поддерживает внутренний order_id, а Payment Information и Payment History помогают мерчантам получать и проверять платежные записи. Вместе эти идентификаторы создают более надежную цепочку расследования.

Как OxaPay помогает расследовать пропавшие платежи

OxaPay предоставляет несколько уровней видимости платежа:

• order_id для внутреннего идентификатора мерчанта;
• track_id для платежной сессии OxaPay;
• Payment Information для конкретного платежа;
• Payment History для более широкого поиска на уровне аккаунта;
• документированные платежные статусы;
• обработку инвойсов для недоплат и просроченных случаев.

Эти инструменты помогают мерчантам определить, является ли заявленный платеж пропавшим, ожидающим, недоплаченным, просроченным, несопоставленным или уже принятым.

Мерчант по-прежнему отвечает за связь платежа со своим заказом, клиентом, выполнением и записями поддержки.

Сначала расследуйте платеж, затем определяйте результат

Пропавший платеж следует рассматривать как вопрос доказательств, а не предположений.

Правильная последовательность расследования:

1. соберите order ID, track ID и TXID;
2. убедитесь, что транзакция существует в ожидаемой сети;
3. сравните актив, адрес, сумму и время;
4. определите, находится ли транзакция в ожидании или подтверждена;
5. проверьте платежную запись OxaPay;
6. сравните ее с заказом мерчанта и статусом выполнения;
7. классифицируйте первопричину и назначьте правильное следующее действие.

Этот процесс предотвращает дублирующие платежи, неправильное выполнение заказов, необоснованные обещания возврата и нерешенные случаи клиентов.

Криптоплатежный шлюз OxaPay предоставляет мерчантам платежные идентификаторы, записи статусов и историю, необходимые для отслеживания платежной активности. Свяжите эти возможности с единым процессом расследования, чтобы клиенты получали понятные ответы, а каждый платеж завершался документированным результатом.

FAQ