merchantapi-docs
Getting Started

Коды ошибок (Payin)

Значения ErrorInfo.Code в ответах Merchant API для Payin Classic и Payin H2H.

Коды ошибок · Payin

Относится к Payin Classic и Payin H2H. Для выплат — см. Коды ошибок Payout.

Формат ответа с ошибкой

Payin Classic (JSON-конверт):

{
  "SuccessCall": false,
  "Datetime": "2009-11-10T23:01:02+03:00",
  "ErrorInfo": { "Code": "invalidData", "Message": "..." }
}

Payin H2H (плоский JSON):

{
  "success": false,
  "errorDescription": "invalid currency"
}
При автоматическом разборе ориентируйтесь на ErrorInfo.Code (Payin Classic) или errorDescription (Payin H2H). Текстовые сообщения — человекочитаемые и могут меняться.

Значения ErrorInfo.Code (Payin Classic)

КодЧто означает
otherErrorУниверсальный код ошибки. Покрывает: ошибку JSON/сети; ошибку подписи или доступа (неверный/отсутствующий ключ, заблокированный/отключённый мерчант, выключенный трафик) — HTTP 403; ошибку валидации бизнес-правил (например malformed request, неподдерживаемый WorkKind, неразбираемый webhook-URL) — HTTP 400. Различайте по HTTP-статусу и сообщению.
invalidDataДанные не соответствуют требованиям. В продакшене не возвращается (используется только в mock-режиме) — реальные ошибки валидации приходят как otherError + HTTP 400.
noCredentialsНе удалось подобрать встречные реквизиты (сообщение no available credentials, please try again later). Возвращается с HTTP 400 — повторите запрос позже.

Политика повторов

  • При otherError из-за временного сбоя (JSON/сеть) запрос можно повторить через 5 секунд. Если причина в подписи/доступе (HTTP 403) или в валидации запроса (HTTP 400) — повтор бесполезен, исправьте запрос/ключ.
  • При noCredentials повторите запрос позже.
  • Для /confirm_topup ошибочный ответ не означает, что запрос не выполнен. Обязательно:
    • повторите запрос спустя несколько секунд, или
    • запросите статус через /topup_status.

Ключи Payout (RSA)

Как сгенерировать RSA-ключ и настроить клиент для Payout API.

Коды ошибок · Payout

Значения code / state / final в ответах Payout API.

Copyright © 2026