Подключение способа оплаты Stripe
Для подключения выполните следующие шаги:
1. Регистрация аккаунта в Stripe
Для регистрации в Stripe перейдите по ссылке https://dashboard.stripe.com/register и заполните форму:
- Укажите номер телефона и введите код, который придёт по SMS.
- Подтвердите адрес электронной почты, перейдя по ссылке из письма, отправленного на вашу почту.
После выполнения этих шагов вы попадёте в личный кабинет.
В личном кабинете необходимо активировать аккаунт. Для этого перейдите в раздел Activate your account, заполните форму активации и нажмите кнопку Activate account.
После активации перейдите в раздел меню Developers → API keys:
На этой странице вы сможете получить следующие ключи:
- Publishable key
- Secret key
2. Добавление способа оплаты в интернет-магазине
Перейдите в панель управления интернет-магазином, выберите раздел «Оплата, доставка, валюта и курсы» и добавьте новый способ оплаты:
Укажите название способа оплаты, установите галочку «Использовать модуль электронных платежей» и выберите в списке Stripe:
Нажмите на ссылку «Настройки модуля». Откроется окно с параметрами:
- Publishable key — указывается из личного кабинета Stripe (раздел Developers → API keys).
- Secret key — также берётся из раздела Developers → API keys.
- Версия API — укажите
v2
. - Webhook-настройки — необходимо задать на странице Developers → Webhooks.
- Доступные способы оплаты — выберите доступные способы, активированные в вашем аккаунте Stripe.
Способ "ideal" доступен только для платежей в EUR. - Курс у.е. магазина к валюте Stripe — указывается вручную при необходимости.
- Валюта продавца — код валюты:
USD
,EUR
,RUB
,UAH
и т. д. - Комиссия платёжной системы (у.е. магазина) — указывается при необходимости включения комиссии в итоговую стоимость заказа.
- Строка "Назначение платежа" — можно использовать метку
$INVOICE_ID$
, она будет автоматически заменена на номер заказа.
3. Webhook-настройки
Эти настройки необходимы для того, чтобы Stripe автоматически уведомлял магазин об успешной оплате заказа.
Перейдите в раздел Developers → Webhooks и нажмите кнопку Add endpoint:
В появившемся окне укажите:
- Endpoint URL — адрес берётся из параметра «Endpoint URL» в настройках способа оплаты магазина.
- Version — выберите API version (2020-03-02).
Использование более новой версии возможно только при наличии соответствующей опции в настройках магазина. - Events to send — выберите
checkout.session.completed
.
Сохраните изменения.
После создания webhook вы попадёте на страницу его настроек. Здесь необходимо:
- Кликнуть по полю Signing secret, чтобы раскрыть ключ.
- Скопировать его и вставить в соответствующее поле в настройках способа оплаты магазина.