Колбэки (CallBacks)
Колбэки — это обратные вызовы от процессинга API к системе партнера. Они позволяют уведомлять партнера о результатах обработки транзакций без необходимости активного запроса к API.
Основное описание
- Колбэк — это POST-запрос от процессинга к системе партнера на предоставленный URL.
- Цель: снижение нагрузки на систему партнера и процессинг.
- Включается опционально (по запросу партнера).
Формат колбэков
Для переводов на карты
Пример сообщения:
{
"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_made",
"message": "Payment completed",
"service": "Mobile payment",
"secret": "SjCT8l1u3tzyBPgYZ5OHxUXVaJhAFe2E",
"requestId": "test-13082024-02-BR"
}
Поля колбэка
| Параметр |
Тип |
Описание |
status |
string |
Статус прохождения транзакции |
message |
string |
Дополнительное описание |
service |
string |
Название услуги (например, "Mobile payment") |
secret |
string |
Секрет для проверки подлинности запроса (алгоритм ниже) |
requestId |
string |
Уникальный идентификатор запроса, связанный с транзакцией |
Возможные значения status для мобильных платежей
| Статус |
Описание |
payment_made |
Платёж успешно завершён |
payment_declined |
Платёж отменен |
payment_error |
Ошибка создания платежа |
Алгоритм формирования secret
| Этап |
Описание |
| 1 |
Сложите строку: ключ + ИНН партнера. |
| 2 |
Примените алгоритм хэширования SHA-1. |
| 3 |
Используйте полученный хэш в поле secret колбэка. |
Параметр secret гарантирует клиенту, что запрос исходит от процессинга.
Убедитесь, что ваш сервер может принимать входящие запросы от API.
Все запросы колбэков отправляются через HTTPS.
Если колбэк не будет принят, система процессинга попытается повторно отправить запрос несколько раз.