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

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

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

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

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

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

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

Проведите тестирование

Начните принимать платежи

 

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

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

Менеджер включит приём платежей после того, как вы отправите технические настройки и подпишете договор с Яндекс.Кассой.

 

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

 

Шаг 3. Проведите тестирование

Для тестирования есть специальный тестовый магазин:

  • в нём не тратятся деньги при платежах,
  • он появляется раньше, чем ваш основной магазин (после того, как вы заполните и отправите техническую анкету). Можно не ждать заключения договора, а сразу настраивать приём платежей.

Тестовый магазин использовать не обязательно: можно сразу всё проверять на реальных платежах с настоящими деньгами.

Как работать с тестовым магазином

 

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

Если хотите тестировать платежи:

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

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

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

1) Зайдите в Настройки, найдите Секретный ключ и нажмите Выпустить ключ.

2) Подтвердите активацию ключа паролем из смс (понадобится привязанный телефон).

3) Пропишите ключ на своей стороне.

Подробнее о ключах

 

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

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

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

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

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

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

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

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

CVC (3D-Secure отключен): 000

CVC (3D-Secure включен): 123

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

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

Примечание: платежи проходят в две стадии. Сначала вы отправляете запрос на оплату, потом вам нужно его подтвердить или отменить. У вас есть 7 дней на подтверждение платежа банковской картой или 2 часа на подтверждение платежа любым другим способом. Если вы не отправите подтверждение в течение этого срока, оплата вернется покупателю.

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

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

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

 

 

Шаг 4. Начните принимать платежи

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