API ЮKassa
Помощь
Подключить ЮKassa
Тестовый магазин
Перед запуском приёма платежей можно проверить всё в тестовом режиме: интеграцию, приём платежей, отправку чеков по 54-ФЗ.
Пока нельзя протестировать только выставление счетов.
Как создать тестовый магазин
Если вы уже зарегистрировались в ЮKassa и у вас есть личный кабинет:
  1. В верхнем меню нажмите на блок с названием магазина (в мобильной версии это иконка магазина), потом на Добавить магазин.
    На компьютере
    На телефоне
  2. Выберите тестовый магазин и укажите, как будете принимать платежи — на сайте или без сайта.
    Если на сайте, напишите его адрес. Если без — ничего писать не нужно.
  3. Нажмите Добавить. Готово, через минуту тестовый магазин появится в списке ваших магазинов.
Если вы ещё не регистрировались в ЮKassa:
  1. Зарегистрируйтесь по этой ссылке. Это короткий путь к тестовому магазину: без юридических вопросов, ИНН и т.д.
  2. В процессе увидите два варианта: продолжить регистрацию или перейти тестированию платежей:
    Выберите тестирование.
  3. Через несколько секунд вы окажетесь в тестовом магазине.
    Когда будете готовы продолжить регистрацию и заключить договор с ЮKassa, нажмите «Вернуться к регистрации» в левом меню.
Как настроить тестовый магазин
  1. Зайдите в тестовый магазин — для этого нажмите на блок с названием магазина в верхнем меню (в мобильной версии это иконка магазина).
    На компьютере
    На телефоне
  2. В боковом меню слева выберите Интеграция — HTTP-уведомления.
  3. Укажите URL, по которому ЮKassa будет отправлять уведомления об успешной оплате в вашу систему. Лучше использовать для тестовых уведомлений отдельный URL (не тот, который вы укажете для уведомлений о настоящих операциях в своём магазине).
  4. Выпустите секретный ключ для тестового магазина:
    1. В боковом меню слева выберите Интеграция — Ключи API, найдите Секретный ключ и нажмите Выпустить ключ.
    2. Подтвердите активацию ключа смс-кодом (нужно привязать телефон к личному кабинету).
    3. Скопируйте ключ (ЮKassa его не сохранит — он будет только у вас) и пропишите на своей стороне.
Как проводить тестовые платежи
С помощью тестового магазина можно протестировать оплату из кошелька ЮMoney и банковской картой. Деньги при тестовых платежах не списываются, но платежи проводятся как настоящие — вам приходят все уведомления от ЮKassa.
  1. Пропишите на своей стороне тестовые данные для аутентификации в ЮKassa:
    • секретный ключ из тестового магазина,
    • идентификатор тестового магазина (shopId).
  2. Сделайте покупку так, как это будут делать ваши покупатели: зайдите в свой интернет-магазин, положите товар в корзину, нажмите Заплатить.
Для оплаты картой используйте нашу тестовую банковскую карту. Платёж по обычной карте в тестовом магазине не пройдёт — будет ошибка.
Платёж из настоящего кошелька тоже не пройдёт. Поэтому перед тем, как тестировать оплату кошельком, нужно выйти из своего аккаунта в ЮMoney.
Как протестировать отправку чеков по 54-ФЗ
Чтобы убедиться, что данные для чеков формируются и передаются правильно, воспользуйтесь режимом проверки чеков в тестовом магазине. Деньги при этом не списываются, но данные для чеков отправляются как настоящие — только не в вашу онлайн-кассу, а в нашу тестовую.
  1. В личном кабинете перейдите в тестовый магазин.
  2. В боковом меню слева выберите Настройки — Онлайн-касса.
  3. Включите режим проверки чеков.
  4. Ниже появятся настройки для подключения нашего сервиса к тестовой онлайн-кассе. Укажите настройки, которые будете использовать с настоящей онлайн-кассой, чтобы всё было как с реальными платежами.
    Настройки чеков
    Что делать с платежом, если чек не доставлен?
    Когда всё настроите, нажмите Применить.
  5. Проведите тестовый платёж.
  6. Проверьте статус чека. Для этого найдите тестовый платёж в Истории платежей и нажмите на него, чтобы посмотреть детали операции — статус чека отображается там.
    Если чек доставлен, значит, данные для чеков передаются правильно — можно подключать онлайн-кассу в настоящем магазине.