Автоматические уведомления

Для информирования торговца о проведенном платеже или об изменении статуса транзакции Overpay высылает POST-запрос на адрес, указанный в параметре notification_url.

Уведомления высылаются при изменении статуса транзакции на pending, expired, failed или successful.

Выполняемый POST-запрос включает в себя авторизационные данные магазина (Shop ID и Secret Key), а также сообщение с телом в формате JSON с параметрами транзакции.

Warning

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

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

Параметр	Тип	Описание
transaction	object
uid	string	UID транзакции.
type	string	Тип транзакции.
status	string	Статус транзакции.
amount	integer	Сумма в минимальных денежных единицах.
currency	string	Валюта транзакции в формате ISO-4217 alpha-3 code. Например, USD.
description	string	Значение из запроса на оплату.
created_at	string	Время создания транзакции (подробнее см. описание формата в поле expired_at запроса на оплату).
updated_at	string	Время последнего обновления данных транзакции (подробнее см. описание формата в поле expired_at запроса на оплату).
method_type	string	Тип способа оплаты.
payment	object
status	string	Статус транзакции, предоставленный провайдером способа оплаты.
gateway_id	integer	Идентификатор платёжного шлюза, который обработал транзакцию.
ref_id	string	Идентификатор транзакции, предоставленный провайдером способа оплаты.
message	string	Сообщение об обработке транзакции, предоставленное провайдером способа оплаты.
{method}	object	Название способа оплаты, с помощью которого была проведена транзакция. Значение и список возвращаемых параметров зависят от способа оплаты, подробнее можно узнать здесь.
customer	object	Секция информации о покупателе.
ip	string	IP-адрес покупателя.
email	string	Адрес электронной почты покупателя.
message	string	Сообщение от системы.
tracking_id	string	Значение tracking_id из запроса на проведение транзакции.
test	boolean	true, если запрос на проведение транзакции является тестовым.
language	string	Значение параметра language из запроса на проведение транзакции.
paid_at	string	Дата проведения транзакции (подробнее см. описание формата в поле expired_at запроса на оплату). Если транзакция еще не завершена, то этот параметр отсутствует.
billing_address	object	Секция информации о покупателе.
first_name	string	Имя покупателя.
middle_name	string	Отчество покупателя.
last_name	string	Фамилия покупателя.
country	string	Страна покупателя.
city	string	Город покупателя.
zip	string	Почтовый индекс или zip-код покупателя.
address	string	Адрес покупателя.
phone	string	Номер телефона покупателя.
birth_date	string	Дата рождения покупателя в формате YYYY-MM-DD.
additional_data	object	Секция дополнительной информации о транзакции.

Пример автоматического уведомления о проведении оплаты

{
  "transaction": {
    "uid": "566fd40a-2379-46d6-aecd-67779afcf883",
    "type": "payment",
    "status": "pending",
    "amount": 1234,
    "currency": "EUR",
    "description": "Description",
    "created_at": "2018-08-08T13:30:54Z",
    "updated_at": "2018-08-08T13:30:54Z",
    "method_type": "method_name",
    "payment": {
      "status": "pending",
      "gateway_id": 1,
      "message": "Transaction has been initialized"
    },
    "method_name": {
      "type": "method_name",
      "account": "user",
    },
    "customer": {},
    "message": "Transaction has been initialized",
    "billing_address": {
      "first_name": "John",
      "last_name": "Doe",
      "country": "DE",
      "birth_date": "1974-02-15"
    },
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    }
  }
}