Интеграция по API

Эта страница рассказывает о подключении по новому API Яндекс.Кассы: теперь прием платежей по умолчанию подключается этим способом. Старый протокол работает как раньше (если хотите использовать его, напишите менеджеру).

Документация

По новому API подключаются все, кто хочет самостоятельно проводить интеграцию и дорабатывать свой платежный модуль, а также некоторые CMS.

Как провести интеграцию

Заполните настройки в личном кабинете

Настройте тестовый магазин

Реализуйте взаимодействие по API

Проведите тестовые платежи

Проверьте возвраты

Сообщите, что всё готово

 

Шаг 1. Заполните настройки

  1. Вы регистрируетесь в Яндекс.Кассе и заходите в личный кабинет (сначала там будут только анкеты, которые нужно заполнить).
  2. В разделе Настройки нажимаете Заполнить.
  3. Указываете URL для уведомлений — это адрес в вашей системе, по которому сервис Яндекс.Кассы будет присылать уведомления.
  4. Нажимаете Сохранить, а затем — Отправить (настройки онлайн-кассы можно заполнить позже: тестировать работу платежей можно без нее).
  5. Параллельно заполняете анкету с информацией о вашей организации (она нужна для заключения договора) и тоже отправляете на проверку.

Как только вы отправите обе анкеты (ваши технические настройки и сведения об организации) в личном кабинете появится ваш первый магазин — тестовый.

 

Шаг 2. Настройте тестовый магазин

1. Зайдите в тестовый магазин: его можно выбрать по кнопке Магазины.

2. В разделе Настройки укажите URL, по которому Яндекс.Касса будет отправлять уведомления об успешной оплате в вашу систему. Хорошо, если этот адрес будет не таким, как для уведомлений о настоящих операциях.

3. Выпустите секретный ключ для тестового магазина. Как выпустить ключ

 

Шаг 3. Реализуйте взаимодействие по API Яндекс.Кассы

 

Шаг 4. Проведите тестовые платежи

С помощью тестового магазина можно протестировать оплату из кошелька на Яндексе и банковской картой.

1. Пропишите на своей стороне тестовые данные для аутентификации в Яндекс.Кассе:

2. Сделайте покупку так, как это будут делать ваши покупатели: зайдите в свой интернет-магазин, положите товар в корзину, нажмите Заплатить.

Для оплаты используйте тестовую банковская карту. Тестовый кошелек не понадобится: в тестовом магазине платежи проходят без участия реального кошелька.

Тестовая карта

Номер карты: 1111111111111026

Действует до: 12  |  25

CVC: 000

При оплате в тестовом магазине все проходит, как при настоящих платежах: вам приходят все уведомления от Яндекс.Кассы, но деньги никуда не переводятся.

Важно: тестовый магазин никуда не исчезает, с его помощью вы всегда сможете проверить работу платежей. Будьте аккуратны: не отдавайте товар, за который заплатили через тестовый магазин. Чтобы избежать накладок, для тестовых уведомлений от Яндекс.Кассы можно использовать специальный URL (его нужно прописать в настройках тестового магазина в личном кабинете).

Примечание: платежи проходят в две стадии. Сначала вы отправляете запрос на оплату, потом вам нужно его подтвердить или отменить. Если вы не отправите подтверждение в течение 6 часов, оплата вернется пользователю.

(Можно проводить платежи в одну стадию, без подтверждения: для этого в первоначальном запросе нужно передать capture=true. Посмотреть в документации)

 

Шаг 5. Проверьте возвраты

Проведите возврат из личного кабинета (для начала — в тестовом магазине). Если собираетесь проводить возвраты по API, проверьте, что всё работает. Документация по возвратам

 

Шаг 6. Сообщите Яндекс.Кассе, что готовы

Когда проверите, что всё работает, сообщите своему менеджеру — он включит вам режим для приема настоящих платежей.