О результате оплаты по счету

URL для отправки уведомления

Партнер предоставляет URL, на который необходимо отправлять уведомления по платежу. Рекомендуем, чтобы URL для уведомлений начинался с https. Так же необходимо ознакомиться с идентификаторами и информации по обработке уведомлений.

Платежный шлюз со своей стороны предоставляет список IP адресов (если требуется), с которых могут быть отправлены уведомления.

Дополнительную проверку подлинности сообщения можно выполнить с помощью запроса: информация о платеже. Но если используется протокол http, то необходимо проводить дополнительную проверку.

Пример url-адресов:

Событие	Stage	Prod
Платеж по счету	https://{host}/{path}/{invoiceId}	https://{host}/{path}/{invoiceId}

{host} - dns имя или ip + port.
{path} - дополнительная часть адреса
{invoiceId} - ид счета, который мы подставим к вашему адресу.

Далее по тексту, комбинация https:// + {host} + {path} - мы заменяем на {merchant_url}.

Платежный шлюз МТС отправляет на указанный в профиле URL уведомления по платежам, если:

платеж по счету был успешно проведен;
платеж по счету был отклонен;

Входные параметры

Уведомление отправляется как HTTP-запрос на адрес, указанный в настройках Партнера, в следующем формате:

Заголовок запроса

POST
Endpoint: {merchant_url}/{invoiceId} HTTP/1.1
Content-Type: application/json

Параметр запроса

Параметр	Тип	Обяз.	Описание
invoiceId	int64	да	ID счета на оплату

Тело запроса

Поле	Тип	Обязат.	Описание
extOrderId	string	нет	Уникальный буквенно-цифровой идентификатор заказа во внешней системе выставившей счет. Данный идентификатор будет передан внешней системе при уведомлении об оплате счета
accountNumber	string	да	Буквенно-цифровой номер счета для банковских счетов – 20-значный номер счета для счетов учета наличных – код, присвоенный в личном кабинете
amount	amount	да	Сумма платежа
currency	string[3]	нет	Валюта платежа, по умолчанию 643
status	int32	да	Статус счета 4 - Paid (Счет оплачен) 5 - Overdue (Счет не оплачен в установленный срок) 7 - Failed (Средства не поступили на счет получателя)
invoiceExpiryDate	dateTime	нет	Требуемая дата оплаты - дата после наступления которой возникает задолженность по оплате
invoiceDate	dateTime	нет	Дата выставления счета
operationDate	dateTime	нет	Время изменения статуса

Выходные параметры

Уведомление считается принятым, если получатель ответил на запрос кодом HTTP 200 OK.

Заголовок ответа

Content-Type: application/json; charset=utf-8
http-code: 200
http-status: OK

Тело ответа

Параметр	Тип	Обязат.	Описание
result	string	да	SUCCESS\|ERROR
errorMessage	string	нет	Если result=ERROR

Пример

Заголовок запроса

POST
Endpoint: {merchant_url}/1150 HTTP/1.1
Content-Type: application/json

Тело запроса

{
  "extOrderId": null,
  "accountNumber": "40702810520030000157",
  "amount": 10.0,
  "currency": null,
  "status": 4,
  "invoiceExpiryDate": null,
  "invoiceDate": null,
  "operationDate": "2022-09-09T14:29:26.573Z"
}

Заголовок ответа

Content-Type: application/json; charset=utf-8
http-code: 200
http-status: OK

Тело ответа

{
  "result":"SUCCESS"
}