Колбэки (CallBacks)¶
Колбэки — это обратные вызовы от процессинга API к системе партнера. Они позволяют уведомлять партнера об изменении статуса верификации ПД и без необходимости активного запроса к API.
Основное описание¶
- Колбэк — это POST-запрос от процессинга к системе партнера на предоставленный URL.
- Цель: снижение нагрузки на систему партнера и процессинг.
- Включается опционально (по запросу партнера).
Формат колбэков¶
Пример сообщения:
{
"idPerson": "dsadkaksdjakld",
"status": 5,
"message": "Denied. The data does not match the image: {patronymic}, {issuedWhom}",
"sign": "67c33001e8192d03a5daf5c8d7381db4fd0685f8”
}
Поля колбэка¶
| Параметр | Тип | Описание |
|---|---|---|
idPerson |
string | Уникальный id верифицируемого |
status |
string | Статус прохождения транзакции |
message |
string | Дополнительное описание |
sign |
string | Название услуги (например, "BRS transfer") |
Возможные значения status¶
Значение поля status |
Пример значения поля message |
Описание |
|---|---|---|
| 1 | Data verified | Данные успешно верифицированы. |
| 3 | Denied. The second page is missing. | Отказано. Отсутствует вторая страница паспорта. |
| 4 | Denied. The image is unreadable. | Отказано. Изображение паспорта не читаемо. |
| 5 | Denied. The data does not match the image: {name}, {patronymic}, {surname}, {birthdate}, {inn}, {series}, {number}, {issueDate}, {issuedWhom}, {registrationAddress} | Отказано. Данные не совпадают с изображением (указаны некорректные поля). |
| 6 | Denied. INN not found | Отказано. ИНН не найден в налоговой службе. |
| 8 | Data requires update | Данные неактуальны – требуется обновление . |
Алгоритм формирования secret¶
| Этап | Описание |
|---|---|
| 1 | Сложите строку: idPerson + ИНН партнера + ключ. |
| 2 | Примените алгоритм хэширования SHA-1. |
| 3 | Используйте полученный хэш в поле secret колбэка. |
Параметр secret гарантирует клиенту, что запрос исходит от процессинга. Убедитесь, что ваш сервер может принимать входящие запросы от API. Все запросы колбэков отправляются через HTTPS. Если колбэк не будет принят, система процессинга попытается повторно отправить запрос несколько раз.