Перейти к содержанию

Колбэки

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

Метод: POST

Параметры

Название
Тип данных Описание
id string ID платежа в системе
transaction string Уникальный номер транзакции на стороне мерчанта
status string Статус транзакции
description string Описание транзакции
amount string Сумма транзакции в копейках
created_at string Дата создания транзакции
extra_data json Дополнительные параметры переданные мерчантом
fiscal_data json Фискализация чека
{
  "id": "fbfe9f88-d5c7-4994-aed6-ee8003f4f342",
  "transaction": "test",
  "status": "completed",
  "description": "Продукт №1",
  "amount": 10000,
  "commission": 0,
  "created_at": "2023-11-30T07:52:29.150747+00:00",
  "extra_data": {
    "ls": "12345"
  },
  "fiscal_data": {}
}

Заголовки

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

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

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

sha256({api-key}{request_body}{secret-key})

где request_body - тело запроса в формате строки:

{\"id\":\"fbfe9f88-d5c7-4994-aed6-ee8003f4f342\",\"transaction\":\"test\",\"status\":\"completed\",\"description\":\"Продукт№1\",\"amount\":10000,\"commission\":0,\"created_at\":\"2023-11-30T07:52:29.150747+00:00\",\"extra_data\":{\"ls\":\"12345\"},\"fiscal_data\":{}}

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

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

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