Интеграции с эквайрингами и платежными системами

Возможности и принципы работы

В рамках релиза “Весна 2021” мы переработали принцип работы со счетами в amoCRM, а также добавили новую категорию интеграций “Банки и эквайринги”.

Теперь продавцы могут выставлять счета через интерфейс amoCRM, и, если в аккаунте включена интеграция с эквайрингом, клиенты смогут оплачивать выставленные счета по прямой ссылке.

Как это работает?

При создании и редактировании интеграций в категории “Банки и эквайринги” разработчику предлагается заполнить поле “Вебхук для формирования ссылки на оплату”.

Это поле имеет две важные особенности:

  1. На время разработки вы можете указать абсолютно любой адрес, главное, чтобы он содержал :account_id и :invoice_id, например http://localhost/:account_id/:invoice_id. При этом, в момент передачи версии на публикацию мы проверим, чтобы ссылка была доступна любому пользователю.
  2. Ссылка на оплату может меняться от версии к версии интеграции. Таким образом, вы можете опубликовать версию интеграции с реальной ссылкой, а при разработке новой версии интеграции снова использовать ссылку для разработки.

При установке интеграции (именно в момент установки), либо при обновлении версии интеграции, amoCRM “запоминает” как выглядит шаблон для формирования ссылки на оплату для аккаунта, в котором интеграция установлена.

Когда продавец отправляет клиенту ссылку на оплату, ссылка формируется следующим образом: в вебхук для формирования ссылки на оплату подставляются идентификаторы аккаунта (:account_id) и счёта (:invoice_id).

Например, вы записали ссылку вот так: https://my.acquiring.best/:account_id/:invoice_id.

При оплате счёта #132 аккаунта #456 клиенту для оплаты будет выдана ссылка https://my.acquiring.best/456/123

Аналогично произойдёт, если параметры будут записаны в query string:

https://my.acquiring.best/?account_id=:account_id&invoice_id=:invoice_id

превратится в https://my.acquiring.best/?account_id=456&invoice_id=123

Одновременно в аккаунте может быть активен только один вебхук для формирования ссылки на оплату, поэтому при установке двух интеграций из категории “банки и эквайринги” будет использован шаблон той интеграции, что установлена последняя.

Например, пользователь установил интеграцию “СберБизнес Эквайринг”, после чего, установил интеграцию “Тинькофф Эквайринг”.

При отправке ссылки на оплату клиенту будет использован “Тинькофф Эквайринг”.

Что должно происходить при переходе по адресу “Вебхук для формирования ссылки на оплату”?

Интеграция должна извлечь из адресной строки идентификатор аккаунта и счёта, а затем получить свойства счёта из указанного аккаунта, после чего предоставить пользователю возможность оплатить этот счёт, например, показав или перенаправив на платёжную форму.

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

Примеры ситуаций, которые необходимо обрабатывать:

Аккаунт может быть недоступен

Это может произойти, если в аккаунте была подключена ваша интеграция, а затем, по какой-либо причине, интеграцию решили отключить. Если части клиентам уже была выслана ссылка на оплату, то они всё так же могут по ней перейти

В этом случае рекомендуется сообщить примерно следующее: “Счёт не найден, пожалуйста обратитесь к тому, кто выставил вам счёт”

Счёт может не существовать

Это может произойти, после того, как клиенту выслали ссылка на оплату, счёт был удалён

В этом случае рекомендуется сообщить примерно следующее: “Счёт не найден, пожалуйста обратитесь к тому, кто выставил вам счёт”

Итоговая сумма счёта может оказаться меньше или равной нулю, либо отсутствуют другие значения, необходимые для оплаты счёта

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

В счёте могут отсутствовать товары (счёт со свободной ценой)

В этом случае можно использовать товар-заглушку

В качестве наименования товара можно использовать название и дату счёта, либо текст “Счёт #123 от …”

Список будет дополняться, но все интеграции, использующие функционал “Вебхук для формирования ссылки на оплату” будут проверяться на корректность обработки указанных сценариев.