Входящие уведомления
Уведомления пригодятся в тех случаях, когда объект API изменяется без вашего участия.
Например, если пользователю нужно подтвердить платеж, процесс оплаты может занять от нескольких минут до нескольких часов.
Вместо того чтобы всё это время периодически отправлять GET-запросы, просто дождитесь входящее уведомление.
| Событие | Объект | Описание |
|---|---|---|
| payment.succeeded | payment | Новый успешный платеж |
| payment.canceled | payment | Неуспешная попытка платежа |
| payment.refund | payment | Возврат платежа |
| subscription.pending | subscription | Регистрация распоряжения на рекуррентный платеж |
| subscription.started | subscription | Старт рекуррентных платежей |
| subscription.canceled | subscription | Отмена распоряжения на рекуррентный платеж |
Использование
Как только произойдет событие, на URL, который вы указали в настройках проекта, придет
[POST]уведомление. В нем будут все данные об объекте на момент, когда произошло событие.Вам необходимо подтвердить, что вы получили уведомление.
Для этого ответьте HTTP-кодом 200. Будет проигнорировано всё, что будет находиться в теле или заголовках ответа. Ответы с любыми другими HTTP-кодами будут считаться невалидными, и уведомления будут повторяться в течение 24 часов, начиная с момента, когда событие произошло.После получения уведомления вы можете проверить текущий статус объекта (запросив информацию о нем GET-методом). Статус объекта должен совпадать со статусом из уведомления.