# ЮKassa

ЮKassa - сервис, принадлежащий компании ЮMoney, ориентированный на бизнес. Предоставляет решения для бизнеса, которые упрощают проведение платежей, во много благодаря множеству различных вариантов оплаты.\
Интеграция с платформой Suvvy открывает дополнительные возможности в работе с клиентами. Теперь в диалоге с клиентом можно сразу перейти к оплате по ссылке за предоставляемую услугу, возможно формирование ссылки как по фиксированному прайс-листу, так и по свободно сформированной сумме во время диалога. Оплата возможна, как в диалоге, так и передана в другие каналы и сервисы.

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

Подключение осуществляется через вкладку **"Интеграции"**, категория **"Платежные системы":**

<figure><img src="/files/3YJ1pyNuoTLDK6slsmqn" alt=""><figcaption></figcaption></figure>

После выбора **"ЮKassa"** переходим непосредственно к подключению, для этого кликните кнопку **"Подключить"**.

<figure><img src="/files/P4JODIzL3nhAftZFCX2u" alt=""><figcaption></figcaption></figure>

Откроется окно подключения, после выбора необходимого способа осуществляете подключение.

<figure><img src="/files/a4Vh6qlmlgJlsjINcvOC" alt=""><figcaption></figcaption></figure>

После корректного подключения, станет доступно следующее окно с настройками:

<figure><img src="/files/RaSaxitnR9Aolk9hfdZL" alt=""><figcaption></figcaption></figure>

## Настройка и возможности:

### Создание оплаты через базовую функцию

Этот вариант подходит для создания ссылки на оплату по фиксированной сумме. Если у Вас сумма одна на одну или на все услуги и требуется сформировать и направить ссылку только в основной диалог, то необходимо выбрать этот вариант.

<figure><img src="/files/aZIb2s36SlMiRpFAnvbE" alt=""><figcaption></figcaption></figure>

После активации флага **"Включить базовую функцию создания оплаты"** Вам будут доступны следующие поля и настройки:<br>

1. Сумма платежа.
2. Описание платежа.
3. Ссылка для возврата.
4. Автоматический прием поступившего платежа. Возможен выбор между оплатой в одну стадию или в две.

### Настройки колл-бэков

![](/files/zuy6YSRSum3hqSXsemuv)

Настройка ответа системы на результат оплаты. Возможны следующие варианты:

1. Платеж прошел успешно.
2. Платеж отклонен.
3. Платеж принят и ожидает подтверждения магазина.

Настройки каждого колл-бэка идентичны. Рассмотрим на примере успешного платежа.

<figure><img src="/files/MLBHphDFaydMwdaxHKM4" alt=""><figcaption></figcaption></figure>

Вы можете выбрать:

1. Отправку фиксированного сообщения от лица бота. В поле **"Текст сообщения"** вводится текст, который будет приходить клиенту в ответ на результат оплаты
2. Генерация сообщения и отправка его от лица бота. В данном случае в поле **"Инструкция"** необходимо написать инструкцию, по которой бот будет отвечать клиенту о результате выполнения платежа
3. Отправка боту заданной инструкции и отправка клиенту полученного сообщения. Более гибкий вариант, похожий на предыдущий, при выборе этого варианта бот будет учитывать, написанную в поле "Инструкция". инструкцию, свою основную инструкцию и Базу знаний. Ответ будет более точным и персонализированным.
4. Вызов прямого вопроса. После выбора этого пункта появляется возможность ответа с использованием файла из "Прямых вопросов".

### Настройки отправки чеков

<figure><img src="/files/axNSyjkDqN2GhsAmEJ1y" alt=""><figcaption></figcaption></figure>

1. Выбирается **Способ отправки чеков** - **email** или **телефон.**
2. **Сообщение для запроса данных клиента -** перед отправкой ссылки для оплаты, бот запросит данные - email или телефон. Сообщение можно изменить.
3. Выбираем **Предмет расчётов** из раскрывающегося списка:

<figure><img src="/files/p0rF1iRL7FVHTpu8f9dw" alt=""><figcaption></figcaption></figure>

4. Выбираем **Тип платежа**:

<figure><img src="/files/GawO6aVaXf6zufYXmDlq" alt=""><figcaption></figcaption></figure>

5. При необходимости указываем количество единиц выбранного в **Предмет расчетов.** По умолчанию расчет идет исходя из 1 единицы услуги, товара или др.

<figure><img src="/files/efW61FCwWiRKldw4e163" alt=""><figcaption></figcaption></figure>

### Создание расширенной оплаты

Для ситуации, когда у Вас есть более одной услуги, цены различаются, формируются свободно в диалоге, либо Вам необходимо передать ссылку для оплаты в другой сервис, необходимо выбрать этот способ.\
Перед настройкой убедитесь, что флаг "Включить базовую функцию оплаты" выключен.

Перейдите в "Действия".

<figure><img src="/files/vDwYtBEkscuvVE7yD9wf" alt=""><figcaption></figcaption></figure>

Создайте новое действие и выберите тип шага - ЮKassa:

<figure><img src="/files/WgEsTkl6exngV2LWDetj" alt=""><figcaption></figcaption></figure>

Заполните основные поля, как при создании любого другого действия, в нашем случае функция этого действия будет называться payment. Создайте аргумент действия. В него будет передаваться сумма за услугу, которую выберет клиент, в нашем примере это *price.*

<figure><img src="/files/vDNueM3jVoXCA2tVGxJJ" alt=""><figcaption></figcaption></figure>

Создайте новый шаг "ЮKassa".

<figure><img src="/files/JqHAWQOc7VDTEHukEMPb" alt=""><figcaption></figcaption></figure>

Переходим к настройкам шага:

<figure><img src="/files/apuJ8UwkMNF4SRx8dsvy" alt=""><figcaption></figcaption></figure>

Укажите название, в поле "Сумма платежа" вставьте аргумент действия.<br>

> Важно! Аргумент добавляется через кнопку "+"\
> В поле "Ссылка для перенаправления после оплаты" вставьте ссылку той страницы, на которую клиент будет переходить после выполнения оплаты, если у Вас нет подходящей страницы, можно использовать одну из наших готовых страниц-заглушек.

Добавьте описание платежа.

Если есть необходимость передавать ссылку в другой сервис, то необходимо поставить галочку "Поместить ссылку на оплату в переменную", после чего ввести имя переменной. В нашем примере назовем переменную payment\_link.

<figure><img src="/files/Kq2eafAdHkRtXkbnsgtK" alt=""><figcaption></figcaption></figure>

Затем по аналогии с базовой оплатой выбрать будет платеж осуществлен в одну стадию или в две.

<figure><img src="/files/7pagVQLGi2HA910aFgEF" alt=""><figcaption></figcaption></figure>

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

```
Передай сумму услуги в аргумент price, вызови функцию payment
```

Представим, что у нас есть необходимость передать ссылку в группу Telegram и у нас есть действие для передачи веб-хука в нашу группу, функция которого называется notification, для этого будем использовать переменную payment\_link, она должна быть аргументом функции notification которую мы создали в настройках нашего шага. В инструкцию добавляем строчку для вызова функции и передачи ссылки:

```
Вызови функцию notification
```

Расширенный метод позволяет Вам создать сценарий оплаты, который будет подходить под Ваши процессы.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.suvvy.ai/ru/integracii/platezhnye-sistemy/yukassa.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.