Перейти к содержимому

Глава 2 · API-интеграция

API-ключи и тестовый режим

Как создать и заменить ключи sk_test и sk_live и проверить интеграцию в песочнице с тестовыми картами.

2 мин чтения

На этой странице
  1. Чем отличаются режимы
  2. Создание ключа
  3. Замена и отзыв
  4. Песочница и тестовые карты
  5. Переход в боевой режим

У каждой кассы есть две независимые среды: Test и Live. Режим определяет ключ: всё, что создано ключом sk_test_…, живёт в тестовом режиме, ключом sk_live_… — в боевом.

Чем отличаются режимы

Test Live
Ключ sk_test_… sk_live_…
Деньги Реальные деньги не двигаются Списываются с реальной карты и зачисляются на баланс кассы
Доступ Работает ещё до одобрения кассы (email подтверждён, касса не заблокирована) Только одобренная активная касса; действует белый список IP
expires_in 300–86 400 секунд, по умолчанию 1 800 300–900 секунд, по умолчанию 900

Режимы полностью изолированы: тестовый ключ не видит боевые объекты и наоборот.

Создание ключа

  1. Откройте раздел Разработчики и выберите кассу.
  2. Переключитесь в нужный режим (Перейти в тестовый режим или Вернуться в боевой режим). В тестовом режиме вверху видна надпись «Тестовый режим — без реальных денег».
  3. На странице Ключи API при желании введите название и нажмите Создать ключ.
  4. Сразу скопируйте ключ — повторно он не показывается.

Замена и отзыв

  • Заменить — создаётся новый ключ, старый перестаёт работать через 24 часа.
  • Отмена (отзыв) — ключ перестаёт работать сразу.

Статусы ключа: Активна, Заменён, Истёк, Отменено.

Не размещайте секретный ключ в коде браузера, мобильном приложении или публичном репозитории — храните его только на сервере. Если ключ утёк, сразу замените его.

Песочница и тестовые карты

checkout_url платежа, созданного тестовым ключом, открывает тестовую страницу оплаты. Реальные карты и деньги там не используются.

Номер карты Результат
8600 0000 0000 0001 Успешно (Uzcard)
9860 0000 0000 0001 Успешно (Humo)
8600 0000 0000 0002 failed, код insufficient_funds
8600 0000 0000 0003 failed, код card_declined
8600 0000 0000 0004 failed, код expired_card
  • Срок действия — любая будущая дата (например, 12/30).
  • SMS-код всегда 111111. После 3 неверных попыток платёж становится failed (otp_attempts_exceeded).
  • Любой другой номер выдаёт ошибку «это не тестовая карта».

Для автотестов без браузера (только с ключом sk_test_, только для платежа в pending):

POST /api/v3/test_helpers/payments/{id}/succeed
POST /api/v3/test_helpers/payments/{id}/fail

Тестовые платежи и события видны в разделе Разработчики → Тестовые платежи и События. Все API-запросы — на странице Журнал запросов.

Переход в боевой режим

Когда всё работает и касса одобрена, замените ключ sk_test_ на sk_live_ — менять код не нужно.

Статья была полезной?

Не нашли ответ?

Отправьте обращение — специалист проверит ваш аккаунт и ответит.