# Интеграция с InvoiceBox

### Общее описание

Платёжная платформа **[InvoiceBox](https://www.invoicebox.ru/ru)** позволяет принимать оплату через платёжные ссылки, которые система автоматически отправляет клиенту.

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

Это позволяет принимать платежи без обязательного присутствия гостя на стойке ресепшен.

### Настройки интеграции

Настройка интеграции выполняется специалистами технической поддержки по запросу пользователя.   
Для обработки запроса необходимо предоставить следующие параметры из сервиса Invoice Box:

- **Идентификатор магазина** - в <span lang="EN-US" style="mso-ansi-language: EN-US;">InvoiceBox</span> это Идентификатор для версии **API l3/v3**
- **Токен магазина** - в <span lang="EN-US" style="mso-ansi-language: EN-US;">InvoiceBox</span> это API токен
- **<span lang="EN-US" style="mso-ansi-language: EN-US;">Api</span>-Ключ магазина** - в <span lang="EN-US" style="mso-ansi-language: EN-US;">InvoiceBox</span> это API ключ
- **Указать значение для НДС**, которое и будет в дальнейшем использоваться при оплатах

[![image.png](https://help.ecvi.ru/uploads/images/gallery/2025-12/scaled-1680-/wbJimage.png)](https://help.ecvi.ru/uploads/images/gallery/2025-12/wbJimage.png)

<span style="mso-no-proof: yes;">  
</span>

<span lang="EN-US" style="mso-ansi-language: EN-US;">Api</span>-ключ и <span lang="EN-US" style="mso-ansi-language: EN-US;">Api</span>-токен (внимательно, из раздела API L3) скопировать ещё раз не получится, их необходимо вставлять сразу при создании интеграции в <span lang="EN-US" style="mso-ansi-language: EN-US;">InvoiceBox. Подробная инструкция от Invoicebox с информацией о получении данных **[по ссылке.](https://docs.invoicebox.ru/docs/merchant/integrationdata/)**</span>

<p class="callout warning">Не забудьте сохранить введённые данные</p>

[![image.png](https://help.ecvi.ru/uploads/images/gallery/2025-12/scaled-1680-/rMrimage.png)](https://help.ecvi.ru/uploads/images/gallery/2025-12/rMrimage.png)

<span style="mso-no-proof: yes;">  
</span>

Полученные от пользователей отеля технические параметры интеграции будут прописаны в модуле   
Администрирование-&gt;Разное-&gt;Стыковки-&gt;InvoceBox и среди системных настроек интеграции предусмотрен блок пользовательских настроек, в котором указывается категория и тип платежа, который будет применяться для оплат, вносимых гостем на лицевой счет в Ecvi (можно создать новые виды оплат с прямым обозначением "Платеж Invoicebox" для выделения из общей массы поступаемых оплат в отеле).

### Работа с <span lang="EN-US" style="mso-ansi-language: EN-US;">InvoiceBox</span> в ECVI

После выполнения указанных выше настроек в системе становится доступна функция формирования платёжной ссылки.  
Сформированную ссылку для оплаты можно:

<div class="pointer-container" id="bkmrk-%C2%A0"><div class="pointer anim "><svg class="svg-icon" data-icon="link" role="presentation" viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"></svg><div class="input-group inline block"> <button class="button outline icon" data-clipboard-target="#pointer-url" title="Копировать ссылку" type="button"><svg class="svg-icon" data-icon="copy" role="presentation" viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"></svg></button></div></div></div>1. **Автоматически отправить по email** — письмо будет направлено на адрес, указанный в профиле главного гостя в карточке бронирования
2. **Скопировать вручную** — после чего отправить клиенту через любой удобный канал связи: мессенджер, SMS и т.д.

Для формирования платежной ссылки перейдите в лицевой счет гостя и нажмите на кнопку "<span lang="EN-US" style="mso-ansi-language: EN-US;">InvoiceBox</span>", расположенной в левой таблице Счета:

[![image.png](https://help.ecvi.ru/uploads/images/gallery/2025-12/scaled-1680-/t8Uimage.png)](https://help.ecvi.ru/uploads/images/gallery/2025-12/t8Uimage.png)

Система откроет окно «Платежные ссылки InvoiceBox». В нём отображается история ранее созданных ссылок, а также доступна кнопка **«Создать ссылку»** для формирования новой:

[![image.png](https://help.ecvi.ru/uploads/images/gallery/2025-12/scaled-1680-/xACimage.png)](https://help.ecvi.ru/uploads/images/gallery/2025-12/xACimage.png)

- Сумма: (по умолчанию устанавливается итоговая сумма из Карточки заявки);
- Шаблон сообщения, который можно отредактировать и дописать нужную информацию при необходимости;
- Галка "Отправить пользователю", при которой платежная ссылка будет автоматически отправлена на указанный в профайле гостя email

В случае, если галка "Отправить пользователю" будет снята, то платежная ссылка не будет отправлена гостю на email, но эту ссылку можно будет скопировать из списка ссылок и отправить гостю удобным способом:

<span lang="EN-US" style="mso-ansi-language: EN-US; mso-no-proof: yes;">![](https://help.ecvi.ru/uploads/images/gallery/2025-10/embedded-image-ejwtp59m.png)</span>

<span lang="EN-US" style="mso-ansi-language: EN-US;"> </span>

В результате гость получит платежную ссылку при переходе по которой сможет оплатить удобным для него способом:

<span lang="EN-US" style="mso-ansi-language: EN-US; mso-no-proof: yes;">![](https://help.ecvi.ru/uploads/images/gallery/2025-10/embedded-image-ze0gs366.png)</span>

В случае успешной оплаты в Ecvi на счёте отобразится платежная операция.

<span lang="EN-US" style="mso-ansi-language: EN-US; mso-no-proof: yes;">![](https://help.ecvi.ru/uploads/images/gallery/2025-10/embedded-image-jjqrg7db.png)</span>

<span lang="EN-US" style="font-size: 10.5pt; line-height: 107%; font-family: 'Segoe UI',sans-serif; color: #444444; background: white;"><span style="mso-spacerun: yes;"> </span></span>При каждой успешно совершенной платежной операции в системе будет выводиться уведомление о факте получения оплаты.

<span lang="EN-US" style="mso-ansi-language: EN-US; mso-no-proof: yes;">![](https://help.ecvi.ru/uploads/images/gallery/2025-10/embedded-image-xm1c6zma.png)</span>

И в личном кабинете <span lang="EN-US" style="mso-ansi-language: EN-US;">InvoiceBox</span> пользователь сможет отслеживать информацию о совершенных платежах с возможностью выполнения возврата:

<span lang="EN-US" style="mso-ansi-language: EN-US; mso-no-proof: yes;">![](https://help.ecvi.ru/uploads/images/gallery/2025-10/embedded-image-k0fihw2l.png)</span>