Общие вопросы

Эта страница собирает ответы на повторяющиеся вопросы, которые не привязаны к конкретному endpoint. Лимиты и тайминги по конкретному API смотрите в Payin H2H.

Сеть и доступ

Белый список IP-адресов

Не используется. Запросы принимаются с любых IP-адресов — достаточно валидной подписи и идентификатора (Key-Id / X-KeyId / username).

С каких IP отправляются webhooks

Список адресов, с которых уходят webhooks, предоставляется по запросу.

Rate limit (ограничения по числу запросов)

Жёстких лимитов на число API-запросов нет.

Время и расписание

Часовой пояс

Сервис работает в МСК (UTC+3). Офсет в датах Payin (Datetime в JSON) — +03:00 (с двоеточием).

Расписание работы

Приём платежей и выплаты идут круглосуточно, 24/7. Отдельных «банковских часов» или окон недоступности по умолчанию нет.

Окружения

Тестовая среда

Отдельной sandbox-среды нет. По запросу вам могут настроить тестовый каскад на ваш аккаунт — обратитесь к менеджеру.

Лимиты сумм

Пополнение мерчантского кабинета (Payin)

Лимиты согласовываются индивидуально — уточняйте у менеджера.

Выплаты

Ответы на частые вопросы по API выплат. Если вашего вопроса здесь нет, задайте его ИИ-ассистенту — кнопка «Спросить ИИ» в шапке сайта.

Какие HTTP-методы используются

Только POST. Других методов нет.

Баланс, выплата и статус — это разные эндпоинты?

Нет, все операции идут через один адрес: https://<url>/api/v1/payment-easy/<username>. Адрес сервера (<url>) и ваше название в системе (<username>) выдаются при подключении. Тип операции определяется содержимым запроса.

В каком формате идёт обмен данными

Всегда XML — и запросы, и ответы.

Какой таймаут ставить на запрос выплаты

Увеличьте время ожидания ответа на запрос выполнения платежа до 5 минут, чтобы HTTP-соединение не обрывалось слишком рано. Запрос статуса отправляйте не ранее чем через 15 минут после завершения запроса на выполнение платежа и повторяйте раз в несколько минут, пока не получите финальный статус (успех или неуспех).

Нужно ли реально держать соединение открытым 5 минут

Обычно ответ приходит практически мгновенно. Запас в 5 минут нужен, чтобы не потерять ответ из-за сетевых сбоев или плохого пинга на маршруте. Если такой возможности нет, можно оставить стандартный таймаут — но тогда особенно важно соблюдать правило: если ответ на запрос создания выплаты не получен, запрос статуса отправляется не ранее чем через 15 минут.

Запрос не уложился в таймаут — можно ли считать, что выплата не создана, и идти дальше по каскаду

Нет. При любом нештатном ответе или отсутствии ответа — как на запрос создания выплаты, так и на запрос статуса — продолжайте отправлять запрос статуса, пока не получите финальный статус. Ответ «не найдено» не всегда означает финальный неуспех, см. таблицу ниже.

При каких HTTP-кодах выплата гарантированно не создана

Ни при каких: протокол не опирается на HTTP-коды. Штатный ответ приходит с кодом 200. Любой другой код считайте нештатным ответом и действуйте так же, как при отсутствии ответа, — опрашивайте статус до финального.

Как интерпретировать статусы выплаты

Решение принимается только по сочетанию трёх значений из ответа:

«Не найден» можно считать неуспехом только если на запрос проведения выплаты вы получили ошибку, нештатный ответ или не получили ответа вовсе, и при этом после запроса на создание выплаты прошло более 15 минут.

Если же на запрос проведения выплаты пришёл штатный ответ, а затем на запрос статуса — «не найден», это нештатная ситуация: не помечайте выплату неуспешной, обратитесь в поддержку или повторите запрос статуса через несколько минут.

Сочетания значений, которых нет в таблице, никак не интерпретируйте: считайте, что ответ от сервера не получен, и продолжайте опрашивать статус.

Есть ли другие признаки, по которым можно понять, создана ли выплата

Нет. Единственный надёжный способ — периодический запрос статуса до получения финального.

Можно ли запросить выплату по своему ID

Да. Запрос статуса отправляется с вашим идентификатором транзакции — тем, что вы передали при создании выплаты.

Куда смотреть дальше