В этом руководстве вы узнаете, как просматривать и редактировать параметры интеграции Stripe в Medusa Admin через модуль интеграций.

Чтобы открыть страницу с настройками Stripe:

1. Откройте Medusa Admin.
2. Перейдите в Настройки → Интеграции → Stripe.

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

---

В первой секции страницы можно изменить секретный ключ, публикуемый ключ и секрет подписи вебхука. Режим ключа задаёт его префикс, поэтому ключи с sk_test_ и pk_test_ принимают тестовые платежи, а ключи с sk_live_ и pk_live_ принимают настоящие. Оба ключа находятся в разделе API keys в Stripe Dashboard, а вместо секретного ключа подходит и ограниченный ключ с префиксом rk_.

Чтобы отредактировать параметры доступа:

1. Перейдите в Настройки → Интеграции → Stripe.
2. В секции Доступы нажмите на меню действий в заголовке секции.
3. Выберите Редактировать.
4. В открывшейся боковой панели измените секретный ключ, публикуемый ключ и секрет подписи вебхука. Откуда берётся секрет подписи, описано в разделе Настройка вебхуков.
5. Нажмите Сохранить.

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

Затем нажмите Проверить соединение. Кнопка обращается к Stripe с секретным ключом, поэтому неверный ключ или ограниченный ключ без доступа к PaymentIntent не пройдут проверку. Если задан секрет подписи, она дополнительно проверяет, что в режиме ключа есть включённый эндпоинт вебхука с /hooks/payment/stripe_ в URL, который отправляет payment_intent.succeeded и payment_intent.amount_capturable_updated. Для ограниченного ключа без доступа к эндпоинтам вебхуков эта проверка пропускается.

---

Секция Поведение определяет тип поведения платежей.

Если выбрано Списать сразу, используется одностадийная оплата. Если выбрано Только заблокировать, используется двухстадийная оплата, и заблокированную сумму вы списываете из заказа в Medusa Admin. Если сумму не списать за 7 дней, Stripe снимает блокировку с карты.

Чтобы изменить поведение оплаты:

1. Перейдите в Настройки → Интеграции → Stripe.
2. В секции Поведение нажмите на меню действий в заголовке секции.
3. Выберите Редактировать.
4. В открывшейся боковой панели измените способ списания.
5. Нажмите Сохранить.

---

Секция Параметры платежа определяет, как платежи выглядят в Stripe и для покупателя.

• Конфигурация способов оплаты это ID конфигурации из раздела Payment methods в Stripe Dashboard, с префиксом pmc_. Без неё способы оплаты, которые видит покупатель, определяет конфигурация вашего аккаунта по умолчанию.
• Описание платежа показывается у платежа в Stripe Dashboard.
• Текст в выписке по карте добавляется в выписку по карте покупателя после префикса из настроек вашего аккаунта Stripe. Stripe принимает только латиницу, хотя бы с одной буквой и без <, >, \, ', " и *, а вместе с префиксом в выписке видно не больше 22 символов.
• Чек на email включает отправку чека от Stripe в live-режиме на адрес, который покупатель указал при оформлении заказа.

Чтобы отредактировать параметры платежа:

1. Перейдите в Настройки → Интеграции → Stripe.
2. В секции Параметры платежа нажмите на меню действий в заголовке секции.
3. Выберите Редактировать.
4. В открывшейся боковой панели измените конфигурацию способов оплаты, описание платежа, текст в выписке по карте и переключатель чека на email.
5. Нажмите Сохранить.

---

Чтобы добавить отображаемый в витрине магазина платёжный провайдер Stripe:

1. Перейдите в Настройки → Регионы.
2. Выберите ваш регион.
3. В первой секции нажмите на меню действий в заголовке секции.
4. Выберите Редактировать.
5. В открывшемся модальном окне добавьте Stripe (STRIPE) в платёжные провайдеры.
6. Нажмите Сохранить.

Добавляйте Stripe только в регионы с одной из валют, которые принимает Stripe. В валютах с тремя знаками после запятой, BHD, JOD, KWD, OMR и TND, Stripe принимает суммы, оканчивающиеся на 0, поэтому плагин округляет итог до сотых, и заказ на 5,124 KWD списывается как 5,120 KWD.

---

Делайте возвраты из заказа в Medusa Admin. Возврат, сделанный в Stripe Dashboard, и спор, который покупатель открыл в своём банке, в Medusa не попадают, и суммы заказа не меняются. Если подписать эндпоинт вебхука ещё и на refund.created, refund.failed и charge.dispute.created, плагин запишет такие возвраты и споры в лог, и их можно будет найти там. Ещё он запишет в лог предупреждение, если Stripe не проведёт возврат, сделанный из Medusa Admin: в заказе эти деньги уже считаются возвращёнными. В этом случае верните деньги покупателю ещё раз в Stripe Dashboard.