Контроль результатов

Для этого можно использовать пользовательские и программные интерфейсы. Но важно помнить, что информация в пользовательских интерфейсах становится доступной с задержкой (как правило, в пределах минуты), в то время как через программные интерфейсы эту информацию можно получать без задержек (с точностью до скорости формирования и передачи сообщений).

Если предпочтительны пользовательские интерфейсы, то можно обращаться к реестрам и карточкам платежей в интерфейсе 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 и ответах от бота, представлена в разделе Работа с информацией об операциях.