# Подключение Stripe

[**Stripe**](https://stripe.com/) — это платежная система для предпринимателей в [более чем 40 странах](https://stripe.com/global), которая позволяет принимать платежи от клиентов по всему миру.

{% hint style="info" %}
Stripe не работает в России и странах СНГ. Для приема платежей от иностранных клиентов в России подключите платежную систему [Robokassa](https://docs.wfolio.pro/payments/robokassa).
{% endhint %}

### Список доступных валют <a href="#currencies" id="currencies"></a>

Доступные валюты включают  EUR, USD, GBP, CHF, DKK, SEK, AUD, KZT, ILS, INR, RON, PLN, BGN, THB, AED, CZK, CAD, BRL. Всего доступно более 130 валют. **Российские рубли не поддерживаются.** Минимальная сумма к оплате варьируется в зависимости от валюты.

<a href="https://docs.stripe.com/currencies?presentment-currency" class="button secondary">Все валюты</a>   <a href="https://docs.stripe.com/currencies?presentment-currency=AU#minimum-and-maximum-charge-amounts" class="button secondary">Минимальная сумма платежа</a>

### Как подготовиться к подключению

Добавьте товары или услуги [на сайт](https://docs.wfolio.pro/shop/site/products) или [в галерею](https://docs.wfolio.pro/shop/gallery/products). Для успешного прохождения проверки платежной системы важно, чтобы были указаны:

* **Описание товаров и услуг.**
* **Стоимость.** Цены и тарифы должны быть видны пользователю перед оформлением заказа.
* **Способы доставки и получения.** Как пользователь получит товар или услугу после оплаты.
* **Контакты и реквизиты.** ФИО, телефон, адрес электронной почты, реквизиты самозанятого или ИП.
* **Ссылка на** [**оферту с юридической информацией**](https://docs.wfolio.pro/legal/terms)**.**

### Как подключить Stripe

* Зайдите на сайт [**Stripe**](https://stripe.com/) и зарегистрируйтесь. Заполните все требуемые поля.
* После регистрации вам на почту придет письмо подтверждения — перейдите по ссылке в письме.
* После подтверждения почты заполните информацию о вашем бизнесе для активации аккаунта. Подробно опишите вашу компанию в каждом пункте. Для этого перейдите по кнопке [**«Add business information»**](https://dashboard.stripe.com/account/onboarding).
* После активации компании перейдите во вкладку **«Developers»** → [**«Webhooks»**](https://dashboard.stripe.com/webhooks). Нажмите на кнопку **«Add destination»**.

<figure><img src="https://355501785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtZOPvCqrx5oWXGbl7B-887967055%2Fuploads%2FtFgxzY6IwWReY3HOMrwe%2Fstripe%20add%20destination.png?alt=media&#x26;token=1ec45744-3074-45fe-a6e1-26cb8e9bea1c" alt=""><figcaption></figcaption></figure>

* В **«Events»** в поиске найдите и выберите события **«checkout.session.completed»** и **«checkout.session.expired»**.

<figure><img src="https://355501785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtZOPvCqrx5oWXGbl7B-887967055%2Fuploads%2FJ9WdNJ82M40bQ6uKeXCI%2Fstripe%20select%20events.png?alt=media&#x26;token=4de30de0-3f3b-4e0d-8df9-961195891f29" alt=""><figcaption></figcaption></figure>

* В «Destination types» выберите **«Webhook endpoint»**.

<figure><img src="https://355501785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtZOPvCqrx5oWXGbl7B-887967055%2Fuploads%2FBwabYc57YPMAPLFm1W8K%2Fstripe%20webhook%20endpoint.png?alt=media&#x26;token=66e98ebe-29f9-47e1-8407-b85d1bc94ef6" alt=""><figcaption></figcaption></figure>

* В пункте **«Endpoint URL»** пропишите этот адрес:

```
https://wfolio.com/gateway/integrations/stripe/notify
```

{% hint style="danger" %}

#### Почему важно вставить правильный адрес в **«**&#x45;ndpoint UR&#x4C;**»**

Если не указать его или указать неверный адрес, данные об оплаченном заказе не поступят на сервер Wfolio.

Статус заказа останется незавершенным и [действие после заказа](https://docs.wfolio.pro/shop/general/add-product#actions) или [покупка цифровых фото](https://docs.wfolio.pro/shop/gallery/digital-photos) не будут выполнены — даже если оплата прошла успешно и вы получили деньги.
{% endhint %}

* Нажмите на **«Create endpoint»**.

<figure><img src="https://355501785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtZOPvCqrx5oWXGbl7B-887967055%2Fuploads%2FMUDvyySIpWmRwYk4Cqrl%2Fstripe%20destination.png?alt=media&#x26;token=eecf6cbf-1bf6-4614-abb0-e9d8ac20be46" alt=""><figcaption></figcaption></figure>

Для подключения системы Stripe понадобится два ключа: секретный API-ключ и секретный ключ вебхука. Сначала опишем, как скопировать и вставить секретный API-ключ.

* Перейдите в раздел «Developers» → [**«API Keys»**](https://dashboard.stripe.com/apikeys), нажмите на кнопку **«Reveal key»** и **скопируйте «Secret key»**.

<figure><img src="https://355501785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtZOPvCqrx5oWXGbl7B-887967055%2Fuploads%2FV3ApjrWutH6Nlcc4nfr4%2Fstripe%20api%20key.png?alt=media&#x26;token=7852bf57-de36-420f-9398-b28692ae7da1" alt=""><figcaption></figcaption></figure>

* Ключ для второго поля находится во вкладке **«Developers»** → [**«Webhooks»**](https://dashboard.stripe.com/webhooks). В разделе **«Webhook endpoints»** перейдите в добавленный endpoint.

<figure><img src="https://355501785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtZOPvCqrx5oWXGbl7B-887967055%2Fuploads%2F9iNoAfdO6z6L48uV5JIc%2Fstripe%20go%20to%20endpoint.png?alt=media&#x26;token=cd9ebeac-f81f-42eb-9cf1-406186fcd9b3" alt=""><figcaption></figcaption></figure>

* В строке **«Signing secret»** нажмите на **«Reveal»**. Скопируйте его.

<figure><img src="https://355501785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtZOPvCqrx5oWXGbl7B-887967055%2Fuploads%2FGbg4Jd0MNn80bcVNrz7m%2Fstripe%20whkey%202.png?alt=media&#x26;token=de0fc8b1-c50b-4f6d-8a9f-2abfd0b20e95" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
В инструкции прописан способ подключения в **тестовом режиме**. Чтобы отключить тестовый режим, нажмите на переключатель **«Test mode»** в верхнем правом углу и **скопируйте ключи** еще раз.
{% endhint %}

Перейдите в раздел магазина **«Платежные сервисы»**. Вставьте скопированные ключи: API-ключ — в поле **«Секретный ключ»**, ключ вебхука (начинается с `wh`) — в поле **«Секретный ключ вебхука»**.

Если нужно, чтобы покупатель ввел физический адрес в окне оплаты, активируйте переключатель «Запрашивать адрес для биллинга».

<figure><img src="https://355501785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtZOPvCqrx5oWXGbl7B-887967055%2Fuploads%2FZuS01ctm8C26RsOyAael%2Fwfolio%20stripe%20keys%20ru.png?alt=media&#x26;token=bbecf2f0-1cb4-40f4-9cb7-02caf2a623c3" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="warning" %}

#### Проведите тестовый платеж после подключения системы

У Stripe есть минимальная для оплаты сумма. Например, для долларов — 0.5 USD. Проверьте сумму для минимального платежа [здесь](https://docs.stripe.com/currencies#minimum-and-maximum-charge-amounts).

Ваш заказ должен отобразиться в разделе **«Магазин» → «Заказы»**.

Если оплата прошла, но заказа нет или спустя несколько часов он появился в разделе «Незавершенные заказы», проверьте настройки платежной системы еще раз. Секретные ключи и адрес в «Endpoint URL» должны быть указаны в соответствии с инструкцией выше.
{% endhint %}