Контроль результатов
В этом подразделе представлены ответы на вопросы о контроле и интерпретации результатов различных платежей, операций и процедур, выполняемых в платформе.
Для этого можно использовать пользовательские и программные интерфейсы. Но важно помнить, что информация в пользовательских интерфейсах становится доступной с задержкой (как правило, в пределах минуты), в то время как через программные интерфейсы эту информацию можно получать без задержек (с точностью до скорости формирования и передачи сообщений).
Если предпочтительны пользовательские интерфейсы, то можно обращаться к реестрам и карточкам платежей в интерфейсе Dashboard (подробнее — в разделе Контроль проведения платежей для Dashboard) и к запросам о состоянии платежей в интерфейсе Telegram-бота технической поддержки (подробнее — в разделе Работа с Telegram-ботом технической поддержки).
Если предпочтительны программные интерфейсы, то можно оперировать оповещениями, отправляемыми от платформы в заданных случаях, и ответами, отправляемыми на запросы о состоянии платежа. В этих оповещениях и ответах используются такие параметры, как status
, code
и message
в объекте payment
и в массивах operations
и errors
(подробнее — в разделах Оповещения и Получение информации о состоянии платежа).
При работе с интерфейсом Gate надо учитывать, что в синхронных ответах на запросы, обрабатываемые по асинхронной схеме, в параметре status
в теле ответа указывается статус запроса, но не платежа или операции. Статус success
в теле ответа свидетельствует о том, что запрос принят в обработку, а статус error
— о том, что запрос не может быть принят в обработку и выполнен. И не более. Информацию об этих статусах и общей структуре и отправке ответов можно найти в разделе Формат ответа.
Чтобы получать информацию именно о состоянии платежей и операций, а не о приёме запросов, стоит оперировать параметрами status
в соответствующих объектах — payment
и operation
— в оповещениях и ответах на запросы о состоянии платежей, либо использовать интерфейс Dashboard. Информация об этом приведена в ответе на предыдущий вопрос.
Наконец, можно отметить, что в некоторых случаях фактическое зачисление средств на стороне платёжных систем осуществляется с существенной задержкой (вплоть до нескольких суток) после того, как операция была подтверждена и получила конечный статус. Поэтому при вопросах о расхождениях между движением средств и статусами платежей и операций можно обращаться в службу технической поддержки ecommpay, а также уточнять статусы конкретных платежей на стороне провайдеров и платёжных систем.
Если во время обработки запроса или выполнения операции возникли ошибки или поводы для отказа, причины их возникновения можно узнать следующими способами:
- В синхронном ответе на запрос, если была обнаружена ошибка при первичной обработке запроса. Информация о таких ошибках представлена в разделе Формат ответа.
- В полученном промежуточном или итоговом оповещении — через код ответа и сообщение, которые могут быть представлены:
- в массиве
errors
, если операция была отклонена на стороне платёжной платформы, например, если операция не прошла проверку на соответствие установленным бизнес-правилам; - в параметрах
operation.code
иoperation.message
, если операция была отклонена на стороне провайдера или платёжной системы.
- в массиве
- В карточке платежа в интерфейсе Dashboard. Информация о работе с реестрами и карточками платежей представлена в разделе Контроль проведения платежей (Dashboard).
- В ответе от Telegram-бота технической поддержки — через код ответа в параметре
unified response
и отдельное сообщение с информацией о причине отказа в проведении платежа или операции.
Информация о возможных ошибках при выполнении операций и о кодах, которые используются в оповещениях, интерфейсе Dashboard и ответах от бота, представлена в разделе Информация об операциях.