Самый простой способ: войдите с помощью Stripe.
Никаких ключей, которые нужно искать, и ничего, что нужно вставлять. Вы входите в Stripe, подтверждаете Coin Moebius и возвращаетесь примерно через минуту. Coin Moebius сохраняет только идентификатор вашей учетной записи Stripe, но не ваши ключи, а Stripe сообщает нам о любых изменениях в вашей учетной записи.
- Откройте «Поставщики» и нажмите Connect a provider.
На панели управления Coin Moebius выберите «Поставщики» в левом меню, затем нажмите Connect a provider в правом верхнем углу.
Coin Moebius → Провайдеры → Connect a provider - Выберите Stripe
Введите Stripe в поле поиска или прокрутите вниз до него и щелкните его.
Connect a provider → Stripe - Назовите его, добавьте две страницы и сохраните.
Дайте соединению псевдоним. Введите URL-адрес успеха (страницу, которую покупатель увидит после оплаты) и URL-адрес отмены (страницу, которую он увидит, если откажется). Оставайтесь на первой вкладке, затем нажмите Save and connect with Stripe.
Псевдоним, URL-адрес успеха, URL-адрес отмены → Save and connect with Stripe Оба адреса должны начинаться с https://. Это единственное, что вы вводите на этом экране.
- Одобрить Stripe
Stripe открывается. Войдите в свою учетную запись Stripe или создайте ее прямо здесь, если у вас ее еще нет, а затем подтвердите Coin Moebius. Stripe показывает, какую учетную запись вы собираетесь использовать, поэтому вы можете проверить ее, прежде чем сказать «да».
Stripe → войдите или создайте аккаунт → одобрите Coin Moebius - Вы вернулись и на связи
Stripe отправит вас обратно на Coin Moebius. Зеленая галочка означает, что платежи по карте готовы, и карта Stripe теперь находится на странице ваших поставщиков с пометкой «Проверено» и «Действующе».
Вернёмся в Coin Moebius: аккаунт Stripe подключен. Провайдеры → ваша карта Stripe: Проверенная, Действующая Увидели вместо зеленой галочки «Требуется действие»? Stripe не завершил очистку вашего счета для платежей по карте. Завершите то, что просит Stripe, вернитесь и нажмите Verify на карточке Stripe.
Другой способ: вставьте свои собственные ключи
Все, что находится ниже, выполняется вручную. Вы настраиваете вебхук на панели управления Stripe, собираете там три значения и вставляете их в Coin Moebius. Планируйте около десяти минут. Если вы вошли в систему выше, вы уже закончили и можете пропустить все это.
Что вам нужно
| Поле | Что оно делает |
|---|---|
| Публикуемый ключ (pk_…) | Публичный ключ, открывающий Checkout в браузере. Не секретный. |
| Секретный ключ (sk_…) | Позволяет нам создать сессию Checkout, чтобы списание прошло через ваш счёт. Секретный. |
| Секрет подписи вебхука (whsec_…) | Подтверждает, что вебхук действительно пришёл от Stripe. Секретный. |
| URL успеха / URL отмены | Куда попадает покупатель после оплаты или отказа. |
Они нужны только для ключевого пути. Если вы вошли в систему с помощью Stripe выше, собирать нечего. Stripe хранит отдельные ключи для тестового режима и Live (pk_test_ / sk_test_ вместо pk_live_ / sk_live_), каждый из которых имеет свой собственный секрет подписи веб-перехватчика. Coin Moebius хранится как на вкладках «Режим работы», так и на вкладках «Тест», поэтому вы можете проверить тестовые ключи и добавить действующие ключи позже, не вводя все заново.
Почему мы спрашиваем каждое поле
Публикуемый ключ
Идентифицирует ваш счёт, когда оформление открывается в браузере покупателя. Публичный по замыслу.
Секретный ключ
Приватная половина, авторизующая создание списания, чтобы платёж прошёл через ваш счёт.
Секрет подписи вебхука
Доказывает, что входящий вебхук подлинно от Stripe, так что никто не подделает событие «оплачено». Это отдельное значение от секретного ключа.
URL успеха и отмены
Простые настройки: куда попадает покупатель после оплаты или отказа. Не секретные.
Настройка
- Используйте тестовый режим (бесплатно)
Счёт Stripe бесплатен, а тестовый режим работает до активации. Войдите на dashboard.stripe.com и включите тестовый режим (в верхнем углу). Настройте сначала тест, затем повторите в боевой среде.
- Скопируйте свои ключи
Перейдите в Developers → API keys и скопируйте публикуемый и секретный ключи.
Stripe → Developers → API keys - Добавьте вебхук
- Developers → Webhooks → Add endpoint.
- Задайте URL эндпоинта на адрес вебхука вашего проекта (ниже).
- Выберите события. Для разовых платежей: checkout.session.completed, charge.refunded, charge.dispute.created. Если вы продаёте подписки, также: customer.subscription.created, customer.subscription.updated, customer.subscription.deleted, invoice.payment_succeeded, invoice.payment_failed. Лишние события безвредны, мы игнорируем то, что не используем.
- Скопируйте секрет подписи эндпоинта (whsec_…). У теста и боевой среды свои собственные.
https://api.coinmoebius.com/webhook/stripe/<your project id>Stripe → Developers → Webhooks → Add endpoint - Тест
Тестовые карты работают только в тестовом режиме и никогда не списывают с реальной карты. Используйте любую будущую дату окончания, любой CVC, любой почтовый индекс.
Результат Карта Успех 4242 4242 4242 4242 Нужна аутентификация 4000 0025 0000 3155 Отклонена 4000 0000 0000 9995 - Подключите в панели управления
Добавить провайдера → Stripe. Введите публикуемый ключ, секретный ключ, секрет подписи вебхука, URL успеха и URL отмены. Используйте тестовые ключи, чтобы проверить поток, затем отредактируйте провайдера и подставьте боевые ключи.
После подключения
Прежде чем начать работу, внесите один платеж:
- Вы вошли в систему с помощью Stripe? Ваша учетная запись активна, поэтому купите продукт стоимостью один доллар с помощью собственной карты и впоследствии верните его через Stripe. Вставил тестовые ключи? Каждый платеж является тестовым, поэтому используйте тестовую карту сверху.
- Создайте товар и поставьте кнопку покупки на страницу (подойдёт локальный HTML-файл), направленную на ваш проект.
- Оформите заказ тестовой картой из списка выше.
- Откройте вкладку «Транзакции». Когда статус новой строки достигнет succeeded, ваши ключи и вебхук оба работают от начала до конца.
Если вы использовали тестовые ключи, отредактируйте провайдера, замените свои живые ключи, и вы принимаете реальные платежи.
Решение проблем
Начните с Verify. На панели управления нажмите Verify на карточке Stripe. Он спрашивает Stripe о вашей учетной записи или проверяет ваши ключи и возвращает конкретное сообщение, если что-то не так.
Я вошел в систему с помощью Stripe и получил сообщение «Аккаунт подключен. Требуется действие».
Ваш аккаунт Stripe подключен, но Stripe еще не разблокировал его для платежей по картам. Откройте Stripe, завершите запрос (обычно сведения о компании или банковский счет), затем нажмите Verify на карточке Stripe в Coin Moebius.
На карточке Stripe написано «Отключено».
Coin Moebius был удален из вашей учетной записи Stripe, обычно со страницы авторизованных приложений в Stripe. Откройте карту, выберите Edit и нажмите Reconnect, чтобы утвердить ее еще раз.
«Проверить» говорит, что формат ключа неверен.
Секретные ключи начинаются с sk_test_ или sk_live_ (ограниченные ключи начинаются с rk_). Секрет подписи вебхука начинается с whsec_. Перекопируйте нужное значение в нужное поле.
«Проверить» говорит, что Stripe отклонил ключ.
Перекопируйте секретный ключ из Developers → API keys и убедитесь, что не сочетаете тестовый ключ с боевым секретом вебхука или наоборот.
Платёж завершается, но заказ остаётся в ожидании.
Вебхук не приходит. Подтвердите, что URL эндпоинта совпадает в точности, что вы выбрали checkout.session.completed и что тестовый платёж попадает на ваш эндпоинт тестового режима (тест и боевая среда, это отдельные эндпоинты).
Проверка подписи не проходит.
У каждого эндпоинта Stripe свой секрет подписи. Скопируйте whsec_ из настроек именно этого эндпоинта, а не другого.
Подтвердите всё от начала до конца.
У Stripe нет кнопки симуляции. В панели Stripe повторно отправьте недавнее событие на ваш эндпоинт или создайте тестовый PaymentIntent, затем смотрите, как обновляется заказ.
Полезно знать
Вошёл через Stripe. Нет ключей или секретов веб-перехватчиков, которые можно было бы копировать, хранить или вращать. Stripe сообщает Coin Moebius, когда ваша учетная запись меняется. Чтобы удалить ссылку, нажмите Disconnect на карточке Stripe или удалите Coin Moebius в разделе «Разрешенные приложения» в Stripe.
Ротация ключей. Вставили свои ключи? В любое время введите секретный ключ или секрет веб-перехватчика, а затем вставьте новое значение. Секретные поля остаются пустыми при редактировании, поэтому вы можете добавить повернутый ключ.
Активация. Боевые ключи работают только после активации вашего счёта для платежей. Тестовые ключи работают сразу.
Вопросы? Join our Discord