Skip to Content
docs
Обратные вызовы

Обратные вызовы (Callbacks)

После обработки платежа и получения ответа от банка Epoint отправляет данные платежа на ваш сервер через POST-запрос на ваш result_url.

Процесс обратного вызова

  1. Epoint отправляет параметры data и signature через POST на ваш result_url
  2. Ваш сервер проверяет подпись для подтверждения подлинности ответа
  3. Ваш сервер декодирует данные для получения информации о платеже

Проверка обратного вызова

Чтобы убедиться, что обратный вызов действительно от Epoint:

  1. Сгенерируйте подпись на вашем сервере, используя полученный data и ваш private_key:
Encode & Sign
1signature = base64_encode(sha1(private_key + data + private_key, 1))
  1. Сравните сгенерированную подпись с подписью, полученной от Epoint

  2. Если они совпадают, ответ является подлинным и не был изменён

  3. Декодируйте данные:

Encode & Sign
1result = json_decode(base64_decode(data))

Параметры ответа обратного вызова

ПараметрОписание
order_idУникальный идентификатор заказа из вашего приложения
statusРезультат транзакции: success или failed
codeКод ответа банка
messageСообщение о статусе платежа
transactionИдентификатор транзакции Epoint
bank_transactionИдентификатор банковской транзакции
bank_responseОтвет банка на платёж
operation_code001 — регистрация карты, 100 — платёж клиента
rrnRetrieval Reference Number — уникальный идентификатор (только для успешных транзакций)
card_nameИмя держателя карты, указанное на странице оплаты
card_maskМаска карты в формате 123456******1234
amountСумма платежа
other_attrДополнительные параметры
trace_idУникальный идентификатор запроса для отладки и поддержки

Статусы платежей

СтатусОписание
newПлатёж зарегистрирован в системе Epoint
successПлатёж успешно завершён
returnedВозврат платежа обработан
errorПроизошла ошибка при обработке платежа
server_errorОшибка проверки статуса

API проверки статуса

Вы можете проверить статус платежа в любое время, используя эндпоинт Получить статус.