Колбэки (CallBacks)

Колбэки — это POST-запросы от процессинга к системе партнера. Они предназначены для уведомления о результатах обработки транзакций без необходимости активных запросов со стороны партнера.

---

Основное описание

• Колбэки отправляются на предоставленный партнером URL.
• Основная цель — снижение нагрузки на систему партнера и процессинг.
• Колбэки подключаются опционально (по запросу партнера).
• Все запросы отправляются через HTTPS.

---

Формат колбэков

Для переводов на карты

Пример сообщения:

{
  "status": "finished",
  "message": "",
  "service": "BRS transfer",
  "secret": "Py7dLqhQc4eoAZbRaUEWHmt08GxwY2vf",
  "requestId": "test_brs_1724208280"
}

Поля колбэка для переводов на карты

Параметр	Тип	Описание
status	string	Статус прохождения транзакции
message	string	Дополнительное описание
service	string	Название услуги (например, "BRS transfer")
secret	string	Секрет для проверки подлинности запроса
requestId	string	Уникальный идентификатор запроса, связанный с транзакцией

Возможные значения status

Статус	Описание
finished	Платёж проведён
cancelled	Платёж отменен
error	Ошибка обработки платежа

Пример сообщения:

{
  "status": "payment_finished",
  "message": "",
  "service": "OZON certificate",
  "secret": "Py7dLqhQc4eoAZbRaUEWHmt08GxwY2vf",
  "requestId": "test_ozon_1724208289"
}

Поля колбэка для сертификатов OZON

Параметр	Тип	Описание
status	string	Статус прохождения транзакции
message	string	Дополнительное описание
service	string	Название услуги (например, "OZON certificate")
secret	string	Секрет для проверки подлинности запроса
requestId	string	Уникальный идентификатор запроса, связанный с транзакцией

Возможные значения status

Статус	Описание
payment_finished	Сертификат успешно выпущен
payment_cancelled	Ошибка выпуска сертификата

---

Алгоритм формирования secret

1. Создайте строку: ключ + ИНН партнера.
2. Примените алгоритм хэширования SHA-1.
3. Полученный хэш используйте в поле secret.

---

Рекомендации

Убедитесь, что ваш сервер:

• Принимает входящие запросы по предоставленному URL.
• Проверяет подлинность каждого колбэка с использованием поля secret.