Рекуррентные платежи

WebHook подписки

Если у вас установлен webhook, то вы получите HTTP-уведомление методом POST в формате application/json.

В заголовке Authorization содержится сигнатура подтверждающая валидность.

name
type
description
type*
int
Тип хука (для рекуррентных платежей 4)
product_id*
uuid
ID продукта
consumer_id*
string
ID подписчика в системе мерча
order_id*
string
Уникальный идентификатор подписки в системе мерчанта
subscription_id*
uuid
ID подписки
invoice_id
string
Уникальный идентификатор платежа (при значении поля status: "activated", "suspended")
status*
string
Статус подписки
activation_time**
string
Дата и время активации подписки (при значении поля status: "activated")
deactivation_time**
string
Дата и время активации подписки (при значении поля status: "deactivated")
deactivated_reason
string
Причина деактивации (при значении поля status: "deactivated")
suspension_time**
string
Дата и время активации подписки (при значении поля status: "suspended")
next_pay_time
string
Дата и время следующего платежа (при значении поля status: "activated", "suspended")
amount
string
Сумма оплаты по платежу (при значении поля status: "activated")
payer_details
string
Маска карты (при значении поля status: "activated")
is_refundable_payment
boolean
Будет ли возвращен платеж, при наличии бесплатного периода (при значении поля status: "activated")

* Поля обязательные для заполнения

** Поля обязательные в случае отсутствия другого такого же поля

Статусы подписки:

activated - активирован

deactivated - деактивирован

suspended - неудачная попытка оплаты подписки

Пример Webhook при активации подписки и успешном платеже:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 { "type":4, "product_id":"94cbc086-1bb3-4ed2-9fff-e857279bfc43", "consumer_id":"c2763", "order_id":"unique123", "subscription_id":"4b9cb63c-43e8-3a6f-b5fe-5dd08eaa013d", "invoice_id":"b49cb63c-43e8-3a6f-b5fe-5dd08eaa013d", "status":"activated", "activation_time":"2023-09-26 11:00:30", "next_pay_time":"2023-09-29 11:00:00", "amount":"100.00", "payer_details":"404040******4040", "is_refundable_payment": false }

Пример Webhook при деактивации подписки:

1 2 3 4 5 6 7 8 9 10 { "type":4, "product_id":"2929a188-4813-4955-8bb0-87378ee9695e", "consumer_id":"c1448", "order_id":"unique123", "subscription_id":"204ee48b-de53-3af5-b32d-3fac7976a07d", "status":"deactivated", "deactivation_time":"2023-09-28 10:59:27", "deactivated_reason":"Деактивация через API" }

Пример Webhook при неудачной попытке оплаты подписки:

1 2 3 4 5 6 7 8 9 10 11 { "type":4, "product_id":"fc315ab9-2b1b-4a4b-a66a-37a237cc36a5", "consumer_id":"c3065", "order_id":"unique123", "subscription_id":"13f3f8eb-347f-35d8-a977-bbdc417379fe", "invoice_id":"b49cb63c-43e8-3a6f-b5fe-5dd08eaa013d", "status":"suspended", "suspension_time":"2023-09-28 11:00:53", "next_pay_time":"2023-09-29 11:00:00" }