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

> 🔌 Канон по технической интеграции Stripe с EasyPay — где живёт checkout, какие домены доступны, требования к юр-документам, события о платежах. По смежным темам:
>
> * Тарифы и комиссии за приём — [FAQ: Комиссии и сколько я реально плачу](https://docs.thenextgen.store/s/635a43c1-37fa-463b-bc7e-7ede7884fce2/doc/skolko-ya-realno-plachu-za-platezhi-T56MasWgTe).
> * Способы приёма — [FAQ: Способы приёма оплат](https://docs.thenextgen.store/s/635a43c1-37fa-463b-bc7e-7ede7884fce2/doc/kakimi-sposobami-klienty-mogut-platit-Xa9RnjrfVU).
> * Приём через PayPal (отдельная ссылка, не Stripe) — [Можно ли принимать оплату через PayPal?](https://docs.thenextgen.store/s/635a43c1-37fa-463b-bc7e-7ede7884fce2/doc/mozhno-li-prinimat-oplatu-cherez-paypal-WVROvxr8oy).

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

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

* Клиент попадает на платёжную страницу, размещённую на одном из доменов EasyPay.
* На странице — стандартная форма Stripe Checkout, поддерживает карты Visa/Mastercard, Apple Pay, Google Pay.
* После оплаты — редирект обратно на ваш сайт (success / cancel URL).

PayPal внутри этой формы не появляется: это отдельная платёжная ссылка, которую под конкретный тариф собирает команда заботы. Как это работает — в карточке [Можно ли принимать оплату через PayPal?](https://docs.thenextgen.store/s/635a43c1-37fa-463b-bc7e-7ede7884fce2/doc/mozhno-li-prinimat-oplatu-cherez-paypal-WVROvxr8oy).

**Альтернатива — 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 — для интеграторов, которым нужны детали платежей не в стандартном формате.

---

**Documents**

- [Отличается ли проходимость платежей от прямого Stripe?](https://docs.thenextgen.store/s/635a43c1-37fa-463b-bc7e-7ede7884fce2/doc/otlichaetsya-li-prohodimost-platezhej-ot-pryamogo-stripe-w9aseAe0bw)
- [Где видеть неуспешные и брошенные транзакции?](https://docs.thenextgen.store/s/635a43c1-37fa-463b-bc7e-7ede7884fce2/doc/gde-videt-neuspeshnye-i-broshennye-tranzakcii-qSVzSI4pCi)
- [Как получить webhook / API на платежи моих клиентов?](https://docs.thenextgen.store/s/635a43c1-37fa-463b-bc7e-7ede7884fce2/doc/kak-poluchit-webhook-api-na-platezhi-moih-klientov-In8KGk1DGY)
- [Как передать ID моего пользователя, чтобы потом найти его в платежах?](https://docs.thenextgen.store/s/635a43c1-37fa-463b-bc7e-7ede7884fce2/doc/kak-peredat-id-moego-polzovatelya-chtoby-potom-najti-ego-v-platezhah-6fnGwF06Ll)
- [Какие требования к Privacy Policy, Terms of Service и Refund Policy?](https://docs.thenextgen.store/s/635a43c1-37fa-463b-bc7e-7ede7884fce2/doc/kakie-trebovaniya-k-privacy-policy-terms-of-service-i-refund-policy-RHUupKmpeT)
- [Как зарегистрировать наш домен в вашем Stripe-аккаунте?](https://docs.thenextgen.store/s/635a43c1-37fa-463b-bc7e-7ede7884fce2/doc/kak-zaregistrirovat-nash-domen-v-vashem-stripe-akkaunte-olFegbYoPb)
- [Можно ли встроить нашу оплату через Stripe Elements / bottom-sheet на свой домен?](https://docs.thenextgen.store/s/635a43c1-37fa-463b-bc7e-7ede7884fce2/doc/mozhno-li-vstroit-nashu-oplatu-cherez-stripe-elements-bottom-sheet-na-svoj-domen-sDZBctRXcc)