Обзор

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

В платформе предусмотрены следующие возможности получать сведения о платежах:

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

При проведении платежей через Gate работа с оповещениями, которые предписывают выполнение определённых действий на стороне веб-сервиса, является обязательной. В остальных случаях от получения оповещений, как правило, можно отказываться, но желательно, напротив, использовать их как наиболее оперативный способ получения информации о каждом проводимом платеже.
Использование Gate API. Если необходимо получать актуальную информацию об отдельных платежах в то время, которое обуславливается спецификой работы веб-сервиса, а не платформы (например, при наступлении определённых событий в веб-сервисе или через заданное время после инициирования каждого платежа), можно использовать специализированные запросы к Gate API (подробнее). Они обрабатываются по синхронной схеме и подразумевают ответы с настраиваемым набором параметров и цифровой подписью. При этом, как и в случае с оповещениями, в ответах на такие запросы используется оперативная информация, без задержек в её обновлении.
Использование Data API. Если необходимо получать в программном виде информацию о результатах проведения платежей за определённые периоды, можно использовать Data API (подробнее). Это может быть актуальным, например, при работе с собственной или сторонней аналитической системой вместо интерфейса Dashboard или в дополнение к нему. Data API позволяет получать информацию об операциях (в том числе отдельно о мошеннических), об опротестованиях операций и о балансах; при этом, поскольку при работе через Data API используется информация из долговременного хранилища, её обновление может выполняться с задержкой вплоть до нескольких минут.
Использование интерфейса Dashboard. Если необходимо получать информацию о результатах проведения платежей через пользовательский интерфейс, можно использовать Dashboard (подробнее). Он позволяет комплексно работать с информацией о платежах и операциях в самых разных срезах и использовать при этом различные реестры, карточки и отчёты, а также выполнять множество действий по управлению платежами. И, кроме того, через Dashboard можно не только получать различные сведения, но и выполнять множество действий по управлению платежами, „белыми“ и „чёрными“ списками платёжных атрибутов, опротестованиями, балансами и многим другим. Вместе с тем, стоит учитывать, что, как и в случае с Data API, при работе через Dashboard используется информация из долговременного хранилища, и её обновление может выполняться с задержкой вплоть до нескольких минут.
Использование интерфейса Telegram. Если необходимо получать информацию об отдельных платежах через интерфейс мессенджера, можно использовать Telegram-бота технической поддержки ecommpay (подробнее). Он может быть удобен для уточнения информации о состоянии платежей, причинах их отклонений и возможных дальнейших действиях в различных ситуациях. При этом, как и в случаях с интерфейсами Data API и Dashboard, при работе через Telegram-бота используется информация из долговременного хранилища, и её обновление может выполняться с задержкой вплоть до нескольких минут.

Помимо этого, при работе с отдельными инструментами (в частности, с SDK для мобильных приложений и платёжным Telegram-ботом) могут быть доступны дополнительные способы получения информации о проведении платежей. Они описываются в статьях о работе с этими инструментами и могут использоваться наряду с указанными здесь основными способами.

В целом же можно отметить, что максимально оперативную информацию можно получать через оповещения и запросы Gate API, максимально полную — через Dashboard и Data API, а максимально удобную — через комбинирование доступных возможностей с учётом специфики веб-сервиса. С вопросами по этой теме всегда можно обращаться к материалам настоящей документации и к специалистам технической поддержки ecommpay.