Надёжность
Лимиты
Ограничения защищают API от перегрузки и случайных циклов в коде. Обычной интеграции их хватает с большим запасом.
X-RateLimit-Limit: 50
X-RateLimit-Remaining: 47
X-RateLimit-Reset: 1762603201Частота запросов
- Боевой ключ sk_live_
- 50 запросов в секунду
- Тестовый ключ sk_test_
- 20 запросов в секунду
Каждый ответ содержит заголовки X-RateLimit-Limit — лимит, X-RateLimit-Remaining — сколько запросов осталось в текущем окне и X-RateLimit-Reset — когда окно обновится (секунды Unix).
При превышении API отвечает 429 с кодом rate_limited и заголовком Retry-After — через сколько секунд повторить. Если лимита не хватает под ваш объём, напишите менеджеру.
{
"error": {
"type": "rate_limit_error",
"code": "rate_limited",
"message": "Слишком много запросов, повторите позже",
"request_id": "req_6e2a91c47d"
}
}async function call(url, init, tries = 5) {
for (let i = 0; i < tries; i++) {
const res = await fetch(url, init);
if (res.status !== 429) return res;
const wait = Number(res.headers.get('Retry-After')) || 2 ** i;
await new Promise((r) => setTimeout(r, wait * 1000));
}
throw new Error('Превышен лимит запросов NordPay');
}Суммы
- Минимальный платёж
- 10 ₽ —
1000копеек - Максимальный платёж
- 600 000 ₽ —
60000000копеек
Сумма вне диапазона вернёт amount_too_small или amount_too_large. Требований к месячному обороту нет — тарифы и ставки описаны на странице тарифов.
{
"error": {
"type": "invalid_request_error",
"code": "amount_too_small",
"message": "Минимальная сумма платежа — 10 ₽",
"param": "amount",
"request_id": "req_b09d3e5f12"
}
}Прочие ограничения
- Ключ идемпотентности хранится 24 часа — подробнее.
- Ваш сервер должен ответить на вебхук за 10 секунд, иначе доставка будет повторена — расписание повторов.
- Временный ключ песочницы действует 24 часа; выдаётся не больше 10 ключей в час с одного IP-адреса.
Idempotency-Key хранится 24 часа
Ответ на вебхук до 10 секунд, код 2xx
Подпись вебхука допуск по времени 5 минут
Ключ песочницы живёт 24 часа, 10 ключей в час с IP