Колбэки

Колбэки используются для получения финального статуса счета. После того как счет получит финальный статус, выполняется запрос на Invoice callback url, указанный в настройках магазина.

Метод: POST

Параметры

Название	Тип данных	Описание
`id`	int	Уникальный номер счета в таблице
`invoice_guid`	string	GUID счета
`invoice_number`	string	Уникальный номер счета в системе
`amount`	string	Сумма счета в копейках
`status`	string	Статус счета
`delivery_type`	string	Способ выставления счета
`delivery_value`	json	Данные для выставления счета
`∟phone`	string	Номер для выставления счета
`∟email`	string	Почта для выставления счета
`expired_at`	string	Дата истечения срока счета
`description`	string	Описание
`created_at`	string	Дата создания счета
`url`	string	Ссылка на счет

{
  "id": 1401,
  "invoice_guid": "a8a4da0f-b4eb-461b-8323-57c3ea37f438",
  "invoice_number": "1578624f-1fd2-43a3-be9a-9ad5f1e07d31",
  "amount": 10000,
  "status": "canceled",
  "delivery_type": "email",
  "delivery_value": {
    "email": "invoice@test.com",
    "phone": "123456789"
  },
  "expired_at": "2022-11-05 10:10:00+00:00",
  "description": "Test description",
  "created_at": "2022-10-27 11:39:15.826311+00:00",
  "url": "https://pay.kvell.group/checkout/invoices/a8a4da0f-b4eb-461b-8323-57c3ea37f438"
}

Заголовки

Также в заголовках запроса передаются:

X-Api-Key - уникальный идентификатор магазина
X-Signature - подпись запроса

Формирование подписи:

sha256({api-key}{invoice_number}{amount}{secret-key})

Доставка колбэка

Отправка колбэка считается успешной, если ответ от сервера мерчанта вернёт статус HTTP-код 200. Любой другой HTTP-код в ответе означает, что запрос не доставлен.

Если первая отправка была неуспешной, то будет предпринято еще 5 попыток каждые 10 минут.