Как интегрировать платежи на своём сайте

🔌 Канон по технической интеграции Stripe с EasyPay — где живёт checkout, какие домены доступны, требования к юр-документам, события о платежах. По смежным темам:

Опорная картина

EasyPay использует Stripe Checkout (hosted на наших доменах) как основной flow:

  • Клиент попадает на платёжную страницу, размещённую на одном из доменов EasyPay.

  • На странице — стандартная форма Stripe Checkout, поддерживает карты Visa/Mastercard, Apple Pay, Google Pay.

  • После оплаты — редирект обратно на ваш сайт (success / cancel URL).

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

Альтернатива — Stripe Elements (встроенная форма оплаты на вашем сайте). EasyPay её не использует по умолчанию: требует регистрации вашего домена в нашем Stripe-аккаунте и более сложной интеграции. Возможно индивидуально.

Что определяет вашу интеграцию

  • Где живёт checkout — на доменах EasyPay (по умолчанию) или на вашем (Stripe Elements, при специальных условиях).

  • Требования к домену вашего сайта — Privacy Policy, Terms of Service, Refund Policy. Это требования Stripe для соответствия compliance; без них checkout может не сработать.

  • Передача metadata — для отслеживания клиентов (например, ID пользователя в вашем приложении) есть стандартный механизм Stripe metadata.

  • События о платежах — webhook от EasyPay (рекомендуется) или API-опрос (опционально).

Когда обращаться к команде заботы напрямую

  • Регистрация нового домена в Stripe-аккаунте EasyPay (например, для Apple Pay на вашем домене).

  • Запрос на интеграцию через Stripe Elements — обсуждаем индивидуально, требует verification.

  • Особые требования к Privacy Policy / Terms of Service — для регулируемых отраслей или нестандартных бизнес-моделей.

  • Технические вопросы по webhook'у — настройка retry, обработка событий, debug.

  • Доступ к расширенным Stripe-объектам через API — для интеграторов, которым нужны детали платежей не в стандартном формате.