Яндекс прием платежей на сайте: Яндекс.Касса: прием платежей на сайте | интернет – Как подключить прием платежей на сайт. Яндекс.Касса

Прием платежей на сайте. Яндекс.Касса

Система приема электронных платежей — Яндекс.Касса — упрощает оплату услуг и товаров на сайтах, в онлайн-сервисах, интернет-магазинах и в офлайне. С ее помощью вы можете выставлять счета, сохранять платежную информацию для повторных списаний, совершать возвраты и решать другие задачи, связанные с интернет-платежами.

Подключить Кассу

Покупатель переходит с вашего сайта в Кассу по кнопке «Заплатить через Яндекс», выбирает оплату банковской картой, электронными деньгами, через интернет-банкинг или другой удобный способ и платит в два счета. Деньги зачисляются уже на следующий день.

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

Как подключить

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

В любом случае нужно разобраться с документами и настройками. Все этапы подключения проходят онлайн:

  1. Отправьте заявку, и у вас появится личный кабинет.

  2. В личном кабинете заполните анкету об организации, загрузите копии требуемых документов (обязателен только паспорт руководителя). На основе этих данных мы сможем заключить договор

  3. Заполните техническую анкету.

  4. Интегрируйте систему приема платежей с сайтом: встройте платежные формы и настройте взаимодействие с Кассой. Без интеграции выставлять счета клиентам можно из личного кабинета или через мобильный терминал.

  5. Проверьте, что прием платежей работает.

Тарифы на прием платежей

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

Базовый уровень комиссии. Действует по умолчанию при обороте до 1 000 000 ₽ в месяц.

Премиум-уровень. При обороте от 1 000 000 ₽ в месяц можно перейти на более выгодный процент.

Если у вашей компании оборот более 5 000 000 ₽ в месяц, мы готовы предложить индивидуальные условия.

Чтобы поменять тариф, напишите менеджеру: [email protected]

Посмотреть тарифы

Способы приема платежей на сайте

Способы, которыми вам будут платить клиенты, вы выбираете при заключении договора с Кассой – список можно посмотреть в личном кабинете. Чтобы добавить новый способ, напишите менеджеру.

Вы можете выбрать следующие варианты получения оплаты:

  • Банковские карты. По умолчанию принимаются платежи с карт Visa (в том числе Electron), Maestro, Masterсard и Мир, выпущенных в России и по всему миру.

  • Электронные деньги – Яндекс.Деньги, WebMoney, QIWI Wallet.

  • Интернет-банкинг – Альфа-Клик, Сбербанк Онлайн, интернет-банк Промсвязьбанка, MasterPass.

  • Продажи в кредит. Проводим платежи через сервис «Заплатить по частям». Покупатель оформляет заявку и в течение нескольких минут получает решение банка. Погашение контролируется кредитной организацией, вы при этом ничем не рискуете.

  • Баланс телефона. Принимаем оплату со счетов мобильных телефонов, подключенных к Мегафону, Билайну, МТС и Tele2.

  • Оплата наличными в терминалах, банкоматах и салонах связи возможна в России и странах СНГ: Армении, Беларуси, Грузии, Казахстане, Кыргызстане, Латвии, Молдове, Таджикистане.

Дополнительные функции

Сделайте оплату проще при помощи дополнительных услуг:

  • Автоплатежи. Позволяют списывать нужную сумму в заданный срок без участия клиента.

  • Привязка карты. Возможность для постоянных клиентов платить без ввода данных карты.

  • Предавторизация. Оплата списывается со стороны магазина, при отмене заказа вы сможете легко вернуть клиенту деньги. Комиссия не взимается.

  • Отправка счета в чате на сайте, социальных сетях и мессенджерах. Отправляйте покупателю платежную кнопку, по которой он сможет перейти в Кассу и заплатить удобным способом.

  • Выставление счетов в смс. Вы отправляете онлайн-запрос на списание нужной суммы. Клиенту приходит смс со счетом. Он подтверждает оплату ответом на это сообщение.

  • Выставление счетов по электронной почте. Отправляйте счета клиентам из личного кабинета Кассы.

  • Оплата через Apple Pay. Владельцу смартфона достаточно подтвердить платеж кодом или отпечатком пальца.

  • Платежи через бота в Telegram. Создайте своего бота и привяжите его к нашему по инструкции.

Все опции активируются бесплатно. Подключение оговаривается с менеджером при заключении договора.

За платежами — в Кассу

Подключайте Яндекс.Кассу, это удобный и надежный сервис для приема платежей.

Подлкючить Кассу

Настройки модуля — Инструкция по разработке платёжного модуля Яндекс.Кассы

Интерфейс настроек

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

Блок 1

Эти поля пользователь заполняет параметрами, которые получил в Яндекс.Кассе. Оба поля обязательны для заполнения. У полей должны быть ограничения:

shopId — можно вводить только цифры, ограничений по количеству символов нет.

Секретный ключ — можно вводить цифры и латинские буквы, ограничений по количеству символов нет.

Техническая документация: аутентификация

Блок 2

Этот блок определяет, где будет процесс оплаты — на сайте Яндекс.Кассы или на сайте пользователя.

Блок 3

Чтобы наши общие пользователи могли работать с ККТ через Яндекс.Кассу, вам нужно передавать нам название, цену и НДС товара при каждом платеже. Клиент настраивает отправку данных специальным тумблером.

Блок 4

Адрес для уведомлений генерируете вы: пользователь не может его отредактировать (только скопировать). Пользователю он потребуется только для обращений в службу поддержки Яндекс.Кассы.

Техническая документация: уведомления

Блок 5

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

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

Блок 1

Если пользователь выбрал На стороне Яндекс.Кассы, разворачивается блок с чекбоксом Назвать кнопку оплаты «Заплатить через Яндекс».

Подробнее о кнопке на сайте Кассы

Блок 2

Если пользователь выбрал На стороне магазина, разворачивается блок Отметьте способы оплаты из договора.

Выбрать сразу оба пункта нельзя. Ничего не выбрать тоже нельзя. По умолчанию отметка стоит На стороне Яндекс.Кассы.

Выбор способа оплаты на стороне Яндекс.Кассы

Блок 3

Если ваши пользователи всегда указывают НДС для товаров или ставка в вашей системе задана по умолчанию, тумблера будет достаточно.

Если в вашей системе НДС — это необязательная настройка, пользователю нужно задать её на этой странице: в этом случае разворачивается блок НДС. В нём два поля — Ставка по умолчанию и Ставка в вашем магазине.

Ставка по умолчанию

Это разворачивающийся список из шести ставок НДС: Без НДС, 0%, 10%, 18%, Расчётная ставка 10/110, Расчётная ставка 18/118.

Нужно выбрать одну, по умолчанию указано 10%.

Сопоставьте ставки

Здесь пользователю нужно сопоставить ставки, которые он уже задал в магазине, со ставками, которые Касса передаёт в налоговую.

Цифра слева — это ставка НДС, которую задал пользователь в вашей системе.

Выпадающий список справа — это ставки НДС для чека в налоговую.

Количество строчек зависит от того, сколько ставок НДС пользователь задал в вашей системе. Если пользователь раньше не задавал ставки на сайте, этого блока не будет.

Техническая документация: оплата по 54-ФЗ

Если есть ошибки, подскажите, где они и как их исправить.

Важные моменты

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

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

Тексты для интерфейса

Скопируйте тексты из файла и вставьте в свой интерфейс.

Интерфейс возвратов

Если в вашей системе есть возможность делать возвраты платежей, пожалуйста, используйте этот шаблон для страницы возврата.

Если пользователь включил отправку данных для чеков через Яндекс.Кассу, интерфейс выглядит так:

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

Тексты для интерфейса

Скопируйте тексты из файла и вставьте в свой интерфейс.

Названия, логотипы и описание сервиса

Название сервиса

Яндекс.Касса — две заглавные буквы, точка посередине, пробелов нет. Название можно склонять:

  • подключение к Яндекс.Кассе,

  • заплатить через Яндекс.Кассу,

  • настройки Яндекс.Кассы.

Кавычки ставятся, только если перед названием стоит слово «сервис». Получится так: Сервис «Яндекс.Касса».

Способы оплаты

Пожалуйста, называйте способы оплаты так, как указано здесь: так ваши пользовали быстрее сориентируются в настройках.

  • Банковские карты — Visa, Mastercard и Maestro, «Мир»

  • Яндекс.Деньги

  • WebMoney

  • QIWI Wallet

  • Наличные

  • Альфа-Клик

  • Промсвязьбанк

  • Сбербанк Онлайн

  • Баланс мобильного — Билайн, Мегафон, МТС, Tele2

  • Кредитование — Заплатить по частям

Логотип

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

Правила размещения:

  • ширина поля — две буквы «Я» из логотипа

  • цвет:

Описание

Если вам где-то требуется описание Яндекс.Кассы (например, в списке платежных систем), используйте этот текст:

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

Способы приёма платежей: банковские карты, Яндекс.Деньги и QIWI, интернет-банки, наличные, баланс мобильного и другие.

Перейти на сайт Яндекс.Кассы

Инструкция по настройке

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

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

Скачать шаблон инструкции

Процесс платежа — Прием платежей по API Яндекс.Кассы

В процессе платежа пользователь совершает следующие действия:

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

 — основная сущность API Яндекс.Кассы для приема платежей.

Чтобы создать платеж, вам нужно передать в запросе :Яндекс.Касса умеет принимать платежи в две стадии, но для простоты вы можете провести обычный платеж (параметр

capture

со значением

true

). Это значит, что сразу после оплаты платеж успешно завершится и перейдет в статус

succeeded

.Также вы можете передать дополнительные данные, например, номер заказа в вашей системе. Яндекс.Касса вернет их без изменений. Данные необходимо передавать в объекте

metadata

в виде набора пар «ключ-значение».

Пример запроса на создание платежа

curl https://payment.yandex.net/api/v3/payments \
  -X POST \
  -u <Идентификатор магазина>:<Секретный ключ> \
  -H 'Idempotence-Key: <Ключ идемпотентности>' \
  -H 'Content-Type: application/json' \
  -d '{
        "amount": {
          "value": "100.00",
          "currency": "RUB"
        },
        "capture": true,
        "confirmation": {
          "type": "redirect",
          "return_url": "https://www.merchant-website.com/return_url"
        },
        "description": "Заказ №1",
        "metadata": {
          "order_id": "37"
        }
      }'
В ответ на запрос придет созданный объект Платежа .

Пример созданного объекта платежа

{
  "id": "2419a771-000f-5000-9000-1edaf29243f2",
  "status": "pending",
  "paid": false,
  "amount": {
    "value": "100.00",
    "currency": "RUB"
  },
  "confirmation": {
    "type": "redirect",
    "confirmation_url": "https://money.yandex.ru/api-pages/v2/payment-confirm/epl?orderId=2419a771-000f-5000-9000-1edaf29243f2"
  },
  "created_at": "2019-03-12T11:10:41.802Z",
  "description": "Заказ №1",
  "metadata": {
    "order_id": "37"
  },
  "recipient": {
    "account_id": "100001",
    "gateway_id": "1000001"
  },
  "refundable": false,
  "test": false
}
Для большинства способов оплаты после создания платежа вам нужно получить согласие от пользователя, что он готов заплатить. Для этого пользователю нужно дополнительно что-то сделать, например, пройти 3-D Secure при оплате банковской картой, подтвердить оплату в платежном сервисе партнера или оплатить счет в интернет-банке.Если от пользователя нужно получить подтверждение, созданный платеж  сначала перейдет в статус

pending

. В следующие статусы (

succeeded

или

waiting_for_capture

) платеж перейдет, только если пользователь согласится внести оплату.Если подтверждение не требуется (например, при оплате через Apple Pay), платеж сразу перейдет в статус

succeeded

или

waiting_for_capture

(если вы проводите платеж в две стадии).Если пользователь передумает платить или что-то пойдет не так (например, на счете не окажется нужной суммы), платеж отменится и перейдет в статус

canceled

.

Яндекс.Касса поддерживает несколько сценариев подтверждения: Redirect, External, QR-код и Embeded.

Сценарий подтверждения Redirect: пользователю необходимо что-то сделать на странице Яндекс.Кассы или ее партнера (например, ввести данные банковской карты или пройти аутентификацию по 3-D Secure). Вам нужно перенаправить пользователя на 

confirmation_url

, полученный в платеже . При успешной оплате (и если что-то пойдет не так) Яндекс.Касса вернет пользователя на 

return_url

, который вы отправите в запросе на создание платежа .

Сценарий подтверждения External: для подтверждения платежа пользователю необходимо совершить действия во внешней системе (например, ответить на смс). От вас требуется только сообщить пользователю о дальнейших шагах.

Сценарий подтверждения QR-код: для подтверждения платежа пользователю необходимо просканировать QR-код. От вас требуется сгенерировать QR-код, используя любой доступный инструмент, и отобразить его на странице оплаты.

Сценарий подтверждения Embedded: действия, необходимые для подтверждения платежа, будут зависеть от способа оплаты, который пользователь выберет в виджете Яндекс.Кассы. Подтверждение от пользователя получит Яндекс.Касса — вам необходимо только встроить виджет к себе на страницу.Один способ оплаты может поддерживать несколько сценариев подтверждения. Особенности подтверждения платежа при оплате разными способами описаны в разделе Способы оплаты.

Вы можете проводить платежи в две стадии:

  1. Холдирование (предавторизация): пользователь вносит оплату, и деньги замораживаются — например, на его банковской карте или в электронном кошельке (зависит от способа, которым он платит).
  2. Списание: замороженные деньги списываются по вашему запросу.
Чтобы создать двухстадийный платеж, передайте в запросе на создание платежа  параметр

capture

со значением

false

.

Пример запроса на создание двухстадийного платежа

curl https://payment.yandex.net/api/v3/payments \
  -X POST \
  -u <Идентификатор магазина>:<Секретный ключ> \
  -H 'Idempotence-Key: <Ключ идемпотентности>' \
  -H 'Content-Type: application/json' \
  -d '{
        "amount": {
          "value": "100.00",
          "currency": "RUB"
        },
        "capture": false,
        "confirmation": {
          "type": "redirect",
          "return_url": "https://www.merchant-website.com/return_url"
        },
        "description": "Заказ №1",
        "metadata": {
          "order_id": "37"
        }
      }'
Как только деньги будут авторизованы, платеж перейдет в статус

waiting_for_capture

. Этот статус означает, что вам нужно принять решение: списать оплату или отменить платеж. Если вы не сделали это за определенное время, платеж перейдет в статус

canceled

, а деньги автоматически вернутся пользователю.В зависимости от способа оплаты у вас есть 6 часов или 7 дней, чтобы списать деньги. Точное время передается в параметре

expires_at

.Чтобы принять оплату, используйте метод capture . По умолчанию списывается вся сумма платежа. Чтобы списать только часть, передайте в запросе объект

amount

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

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

Пример запроса на списание всей суммы платежа

curl https://payment.yandex.net/api/v3/payments/{payment_id}/capture \
  -X POST \
  -u <Идентификатор магазина>:<Секретный ключ> \
  -H 'Idempotence-Key: <Ключ идемпотентности>' \
  -H 'Content-Type: application/json'

Пример запроса на частичное списание

curl https://payment.yandex.net/api/v3/payments/{payment_id}/capture \
    -X POST \
    -u <Идентификатор магазина>:<Секретный ключ> \
    -H 'Idempotence-Key: <Ключ идемпотентности>' \
    -H 'Content-Type: application/json' \
    -d '{
          "amount": {
            "value": "2.00",
            "currency": "RUB"
          }
        }'
Если вы хотите отказаться от оплаты, то отмените платеж с помощью метода cancel . Платеж перейдет в статус

canceled

, и деньги вернутся пользователю. В этом случае Яндекс.Касса не будет удерживать комиссию за проведение платежа.Вы можете отменить только платежи в статусе

waiting_for_capture

. Если платеж перешел в статус

succeeded

, вы можете создать возврат.

Пример запроса на отмену платежа

curl https://payment.yandex.net/api/v3/payments/{payment_id}/cancel \
    -X POST \
    -u <Идентификатор магазина>:<Секретный ключ> \
    -H 'Idempotence-Key: <Ключ идемпотентности>' \
    -H 'Content-Type: application/json' \
    -d '{

        }'
Жизненный цикл платежа зависит от настроек вашего магазина и параметров, которые вы передадите в запросе на создание платежа . Каждому этапу жизненного цикла соответствует статус платежа .

pending

 — платеж создан и ожидает действий от пользователя. Из этого статуса платеж может перейти в 

succeeded

,

waiting_for_capture

(при двухстадийной оплате) или

canceled

(если что-то пошло не так).

waiting_for_capture

 — платеж оплачен, деньги авторизованы и ожидают списания. Из этого статуса платеж может перейти в 

succeeded

(если вы списали оплату) или

canceled

(если вы отменили платеж или что-то пошло не так).

succeeded

 — платеж успешно завершен, деньги будут перечислены на ваш расчетный счет в соответствии с вашим договором с Яндекс.Кассой. Это финальный и неизменяемый статус.

canceled

 — платеж отменен. Вы увидите этот статус, если вы отменили платеж самостоятельно, истекло время на принятие платежа или платеж был отклонен Яндекс.Кассой или платежным провайдером. Это финальный и неизменяемый статус.

В зависимости от вашего процесса часть статусов может быть пропущена, но их последовательность не меняется.

Оплата по 54-ФЗНеуспешные платежиВходящие уведомленияТестирование

Использование SDK — Прием оплаты API Яндекс.Кассы

Официальные библиотеки:

Библиотеки, разработанные сообществом:

С помощью мобильных SDK Яндекс.Кассы вы можете встроить платежную форму в ваше мобильное приложение на iOS и Android. Пользователям не придется во время оплаты переходить на страницу Яндекс.Кассы для ввода платежных данных.

Мобильные SDK обменивают данные, которые ввел пользователь, на одноразовый платежный токен. Вам нужно отправить этот токен Яндекс.Кассе в запросе на создание платежа.Способы оплаты, которые поддерживает SDK: банковская карта, Apple Pay, Сбербанк Онлайн, Яндекс.Деньги

Требования: iOS 8.0, 9, 10, 11 и 12

Есть демо-приложение

Подробнее об iOS SDKСпособы оплаты, которые поддерживает SDK: банковская карта, Google Pay, Сбербанк Онлайн, Яндекс.Деньги

Требования: Android 4.0 (API 14) или новее

Есть демо-приложение

Подробнее об Android SDK

С помощью веб SDK Яндекс.Кассы вы можете встроить платежную форму в ваш сайт. Пользователям не придется во время оплаты переходить на страницу Яндекс.Кассы для ввода платежных данных. Виджет Яндекс.Кассы позволяет встроить платежную форму с несколькими способами оплаты, YandexCheckout.js и YandexCheckout UI — только форму для оплаты банковской картой.

Позволяет встроить форму для приема платежей, в которой пользователь выбирает способ оплаты и вводит данные. В процессе оплаты вам не надо взаимодействовать с пользователем — Яндекс.Касса сделает это за вас.

Платеж будет проходить по самому простому сценарию.

Способы оплаты, которые поддерживает SDK: банковская карта, Apple Pay, Google Pay, Яндекс.Деньги, Сбербанк ОнлайнПодробнее о виджете Яндекс.КассыSDK устарел. Для встраивания формы рекомендуется использовать виджет.Позволяет создать платежную форму для сбора данных банковской карты. SDK обменивает собранные данные на платежный токен. Вам нужно отправить его Яндекс.Кассе в запросе на создание платежа и реализовать нужный сценарий подтверждения.

Вы можете использовать свой дизайн или готовый (с помощью YandexCheckout UI).

Подробнее о YandexCheckout.jsSDK устарел. Для встраивания формы рекомендуется использовать виджет.

Готовая платежная форма для работы с YandexCheckout.js. Дизайн формы меняется в зависимости от данных банковской карты. SDK проверяет корректность введенных данных «на лету».

Подробнее о YandexCheckout UIОбработка входящих уведомлений с помощью SDKБыстрый стартСценарии интеграцииПлатежный токен

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *