# Платежный шлюз

С помощью Navixy вы можете предоставить своим клиентам возможность онлайн-платежей с использованием Stripe или других популярных систем.

## Приём платежей через Stripe

Вы можете легко интегрировать Stripe для автоматического получения онлайн-платежей от ваших клиентов.

{% hint style="info" %}
Stripe — это глобальный платёжный процессор, который поддерживает более 100 валют и доступен более чем в 30 странах. Интегрировав Stripe с Navixy, вы можете принимать онлайн-платежи с помощью различных методов, включая банковские карты (Visa, Mastercard, American Express), Google Pay, Apple Pay, Alipay и многие другие.
{% endhint %}

Чтобы активировать интеграцию со Stripe, обратитесь к вашему менеджеру по работе с клиентами за помощью. После активации вам потребуется настроить следующие технические параметры в вашей учетной записи Stripe:

1. Если у вас еще нет учетной записи Stripe, создайте её по адресу <http://stripe.com>.
2. Настройте методы оплаты, которые вы хотите принимать (например, банковские карты, цифровые кошельки) в панели управления Stripe.
3. Сгенерируйте ваши API-ключи и добавьте их в вашу учетную запись Navixy, чтобы обеспечить обмен данными между платформами.

Инструкции ниже проведут вас через конкретную конфигурацию, необходимую для интеграции Navixy и Stripe.

### Как настроить webhook Stripe

1. Войдите в [панель управления Stripe](https://dashboard.stripe.com/).
2. Перейдите в [Developers → Webhooks](https://dashboard.stripe.com/account/webhooks).
3. Нажмите **Добавить endpoint**. Заполните поля в диалоговом окне. Параметр **Endpoint URL** зависит от того, где развернут ваш сервис (EU или US сервер).\
   EU платформа: `https://saas.navixy.com/api-v2/external/payments/<PlatformID>/stripe`\
   US платформа: `https://saas.us.navixy.com/api-v2/external/payments/<PlatformID>/stripe`\
   Замените `<PlatformID>` на ваш конкретный идентификатор платформы. Как правило, это номер вашей панели или идентификатор, используемый для входа в Admin панель.

#### **Фильтрация событий**

В разделе **Выберите события для отслеживания** (или **Выберите типы для отправки**) разделе выберите только следующие 4 пункта:

1. `charge.refunded`
2. `payment_intent.amount_capturable_updated`
3. `payment_intent.succeeded`
4. `payment_intent.payment_failed`

#### **API-ключи Stripe**

Вы должны предоставить ваши API-ключи Stripe команде поддержки Navixy для завершения интеграции.

**Стандартные API-ключи**

Перейдите в **Developers → API keys**. Получите следующие два параметра:

* `Publishable key`
* `Secret key`

**Webhook signing secret**

Перейдите в **Developers → Webhooks**. Нажмите на созданный вами webhook endpoint. В разделе Signing secret нажмите **Reveal** чтобы получить ключ:

* `Signing secret`

После выполнения этих шагов вы будете готовы принимать онлайн-платежи.

## Приём платежей другими методами

Вы можете использовать практически любой метод оплаты, создав кастомный скрипт для приёма онлайн-платежей. Ваш скрипт должен быть доступен по URL и обрабатывать платежи, вызывая [Navixy Billing API](https://www.navixy.com/docs/navixy-api/user-api/backend-api/resources/billing).

### Интерфейс для пользовательских методов оплаты

Чтобы настроить кастомный платежный шлюз:

1. Перейдите в [Service preferences](https://www.navixy.com/docs/admin/ru/settings/service-preferences) в настройках Admin панели Navixy.
2. Введите URL платежной системы.

Ваша платежная система должна обрабатывать параметр `/?id={id}`.

После того как вы укажете **Payment system URL** в разделе **Domain & URLs** раздела **Service preferences**, в профиле появится **Опция пополнения средств** опция будет доступна в [Profile](https://app.gitbook.com/s/446mKak1zDrGv70ahuYZ/guide/account/profile) разделе веб-платформы:

<figure><img src="https://4285393472-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKdgeXg71LpaDrwexQYwp%2Fuploads%2FliBVaeL4ehwe2pRaCLOG%2Fimage.png?alt=media&#x26;token=66e556b7-2aad-4b1a-b88f-da424577fa6c" alt="Add money link" width="375"><figcaption><p>Опция пополнения средств</p></figcaption></figure>
