API-ключи и тестовый режим
Как создать и заменить ключи sk_test и sk_live и проверить интеграцию в песочнице с тестовыми картами.
На этой странице
У каждой кассы есть две независимые среды: Test и Live. Режим определяет ключ: всё, что создано ключом sk_test_…, живёт в тестовом режиме, ключом sk_live_… — в боевом.
Чем отличаются режимы
| Test | Live | |
|---|---|---|
| Ключ | sk_test_… |
sk_live_… |
| Деньги | Реальные деньги не двигаются | Списываются с реальной карты и зачисляются на баланс кассы |
| Доступ | Работает ещё до одобрения кассы (email подтверждён, касса не заблокирована) | Только одобренная активная касса; действует белый список IP |
expires_in |
300–86 400 секунд, по умолчанию 1 800 | 300–900 секунд, по умолчанию 900 |
Режимы полностью изолированы: тестовый ключ не видит боевые объекты и наоборот.
Создание ключа
- Откройте раздел Разработчики и выберите кассу.
- Переключитесь в нужный режим (Перейти в тестовый режим или Вернуться в боевой режим). В тестовом режиме вверху видна надпись «Тестовый режим — без реальных денег».
- На странице Ключи API при желании введите название и нажмите Создать ключ.
- Сразу скопируйте ключ — повторно он не показывается.
Замена и отзыв
- Заменить — создаётся новый ключ, старый перестаёт работать через 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_ — менять код не нужно.