Сверка (чтение платежа)

GET /v1/payments/{public_reference} возвращает актуальное состояние платежа. Это ваш источник для сверки.

Запрос

Метод и путь: GET {ELEVENPAY_BASE_URL}/v1/payments/{public_reference} (базовый адрес вам выдают при подключении — см. Окружения)

Заголовок: Authorization: Bearer <API_KEY> (возможность payment.read).

curl "$ELEVENPAY_BASE_URL/v1/payments/ep1_7t4k2m8q9x3v6b1n5c0d2f4a8h" \
  -H "Authorization: Bearer $ELEVEN_PAY_API_KEY"

Ответ

200 OK с объектом платежа. Неизвестная, некорректная или чужая ссылка возвращают одинаковый 404 payment_not_found — без раскрытия, к какому случаю относится ссылка.

Вебхуки и GET дополняют друг друга

Доставка вебхуков — не менее одного раза (at‑least‑once): одна доставка не является «ровно‑один‑раз»‑истиной. Используйте GET как авторитетную сверку.

Запрашивайте GET:

• при неопределённости после обработки вебхука;
• после сбоя/недоступности вашего сервера;
• при статусе outcome_unknown;
• если ожидаемый вебхук не пришёл;
• после повтора создания, если у вас есть reference.

Повторы и таймауты

GET безопасно повторять при временных сетевых ошибках и 5xx — по обычной политике HTTP‑клиента. Задавайте разумные таймауты на соединение и чтение.

Частота опроса

Публичного контракта на частоту опроса и лимиты сейчас нет. Опрашивайте консервативно, согласно политике вашей интеграции; не выстраивайте агрессивный поллинг. Точные лимиты будут сообщены при онбординге.