ZefirPayAPI v2
Поддержка
Разделы документации

Ошибки

При ошибке API возвращает HTTP-код ошибки и объект с описанием:

{"error": "Неверная подпись sign", "status": 422}
ПолеТипОписание
errorstringОписание ошибки
statusintegerHTTP-код ответа

Коды ответов

КодЗначениеОписание
400Bad RequestЗапрос нельзя выполнить в текущем состоянии платежа
401UnauthorizedAPI-ключ не передан или неверен
403ForbiddenНет доступа к магазину
404Not FoundПлатёж или ресурс не найден
422Unprocessable EntityОшибка в параметрах запроса
500Internal Server ErrorВнутренняя ошибка. Повторите запрос позже
503Service UnavailableСервис временно недоступен. Повторите запрос позже

Частые ошибки

СообщениеЧто проверить
unauthorizedЗаголовок Authorization: Bearer <API-ключ> и сам ключ
Неверная подпись signПорядок полей в подписи, секретный ключ и то, что amount подписан в том же виде, что и отправлен
Некорректная сумма amount: нужен формат 1000.50Сумма — строка с не более чем двумя знаками после точки
Сумма должна быть от 10.00 до 300000.00 руб.Лимиты одного платежа
Поддерживается только валюта rubПоле currency
Магазин не найденПоле shopId и то, что магазин подключён к вашему API-ключу
Заказ с таким uuid уже оплаченЗаказ уже оплачен — повторная оплата не нужна
Для этого uuid уже создан платёж с другой суммойДля другой суммы используйте новый uuid или дождитесь отмены прежнего платежа
Вернуть можно только оплаченный платёжСтатус платежа перед возвратом

Ошибки проверки параметров содержат имя поля, например: uuid: Field required.