«AquiroPay» — интеграция

Заключение договора с AcquiroPay

При заключении договора на предоставление услуг интернет-эквайринга от процессингового центра AcquiroPay необходимо указать следующее:

Способ подключения

Требуемый способ подключения – Acquiro Payment Page - http://acquiropay.ru/ru/unikalnye-sposoby-integratsii/acquiro-payment-page

Данный платежный инструмент является традиционным способом приема платежей в интернет и является наиболее простым для интеграции в систему управления магазином. Безопасность данного способа приема платежей обусловлена тем, что данные своей карты держатель вводит в полностью защищенную страницу системы AcquiroPay, оператор интернет магазина не видит данных карты, они моментально передаются по защищенным каналам в банк-эквайер.

Метод авторизации

В качестве метода авторизации выберите TOKEN-авторизацию.

Модель проведения платежа

Необходимо запросить модель проведения платежа: двухстадийный платеж – предавторизация/списание. Авторизация средств – блокировка на карте плательщика нужной суммы платежа. Срок блокировки не превышает 30 суток (согласно Правилам платежных систем), но может быть и меньше согласно правилам Банка-эквайрера.

Протокол поддерживает: отмену платежа – сумма платежа будет разблокирована или подтверждение платежа – сумма платежа будет списана.

Если Торговец не совершил ни одного действия с авторизованным платежом – заблокированная сумма будет «разморожена» по истечении срока блокировки.

Обратите внимание на следующее:
По умолчанию функция CAPTURE (финансового завершения операции) отключена! Чтобы иметь возможность «холдировать» средства – обратитесь к вашему личному менеджеру или напишите запрос по e-mail merchants@acquiropay.ru с обязательным указанием наименования вашей компании, номера и даты договора и обоснования необходимости использования двух стадийной схемы проведения платежей.

Запросите у вашего менеджера AcquiroPay включение операции CAPTURE, иначе вы не сможете проводить списание денежных средств в личном кабинете SLETAT.RU

Адреса возврата пользователя

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

OK_URL = http://globaltps.ru/acquiropay/completeholdinghandler.ashx
KO_URL = http://globaltps.ru/acquiropay/completeholdinghandler.ashx?sl_error=1

ВАЖНО:
При указания данных пунктов важно указать, что данные адреса являются статичными.

ВАЖНО:
Очень важно при заключении договора на предоставление эквайринговых услуг указать, что по завершении платежной операции НЕ ТРЕБУЕТСЯ показывать страницу с результатом платежной операции. За логику отображения результата платежной операции будет отвечать сама страница возврата.

Адреса для возврата должны быть указаны именно эти. Как в случае успешной оплаты, так и в случае неуспешной покупатель будет возвращен к той странице, на которой первоначально был совершен online-заказ, с предоставлением результата проведенной платежной операции - успешна или неуспешна (в случае неуспешности оплаты будет показано сообщение и причина ошибки). Указанные адреса - это обработчики от компании Слетать.Ру. При получении ответа со стороны платежной страницы процессиногового центра AcquiroPay данные обработчики вернут пользователя к той странице, на которой он производил первоначальный поиск и на которой ему была показана карточка счета (лист бронирования) для последущего перехода к платежной странице процессинга.

Нотификация

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

CB_URL = http://globaltps.ru/acquiropay/{идентификатор-вашего-турагенства}/callbackhandler.ashx

Этот адрес вы можете увидеть в настройках провайдера в личном кабинете SLETAT.RU https://sletat.ru/workspace/billingsettings.aspx :

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

С какой целью требуется настройка этого адреса? 
Представьте, покупатель совершил платеж, процессинговый центр AcquiroPay показал ему статус платежной операции, но вы, как менеджер турагенства, этот статус (платеж совершен, платеж не совершен вследствии какой-либо причины) не получаете, так как AcquiroPay не знает, кого оповестить. Адрес оповещения как раз и решает эту задачу, а именно, принимает статус проведенной денежной операции и оповещает менеджеров турагенства об успешности/неуспешности платежной операции в режиме реального времени. Само по себе оповещение  (SMS, Email) осуществляется в таком случае компанией SLETAT.RU, получив запрос на указанный адрес от процессинга AcquiroPay. 

Важно: 
Без указания данного адреса оповещения вы все равно получите реальный статус проведенной операции, НО, только по истечении 25 минут после того момента, как покупатель перешел на платежную страницу AcquiroPay для осуществления платежа.

Необходимый набор команд

• Блокировка средств (в рамках двухстадийного списания)
• Списание CAPTURE (вторая стадия после блокировки)
• Отмена платежной операции/отмена авторизации/возврат
• Запрос минивыписки
• Сервис проверки статуса платежа

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

После заключения договора с процессинговым центром AcquiroPay вы получите:

• идентификатор продавца
• секретное слово

Это набор текстовых данных, строка, сообщаемая Торговцу Аккаунт-менеджером ACQUIRO, для обеспечения целостности передаваемых данных и авторизации Торговца на Платежной форме. Это «Слово» должно быть известно только Торговцу и системе ACQUIRO

• идентификатор оплачиваемого Продукта в категории FREE PRICE — это Продукт, для которого возможно определение цены (отличной от предустановленой) посредством HTTP-запроса к Платежной форме.
• адрес формы оплаты платёжного шлюза (в тестовом режиме используется адрес https://secure.acquiropay.com/ )
• адрес API платежного шлюза AcquiroPay (в тестовом режиме используется адрес https://gateway.acquiropay.com/ )
• параметры доступа к личному кабинету через web интерфейс (логин, пароль для входа).

Все эти параметры (кроме аккаунта для доступа в личный кабинет) вам необходимо будет заполнить в соответствующие настройки провайдера в личном кабинете SLETAT.RU на странице https://sletat.ru/workspace/billingsettings.aspx. После заполнения все настроек вы должны увидеть результат, похожий на следующее:

Проверка правильной настройки провайдера AcquiroPay

В правильности указания идентификатора оплачиваемого продукта в категории FREE_PRICE вы можете убедиться, посмотрев раздел «Продукты» в личном кабинете AcquiroPay:

Обратите внимание на тип: FREE_PRICE

Убедиться в том, что вам правильно завели адрес для оповещений (раздел «Нотификация») можно, посмотрев подробности по данному продукту.

Обратите внимание на поле “URL для уведомлений:”

Проведение тестовых платежей

После полной настройки вашего провайдера вы можете принимать оплату у себя на сайте. AcquiroPay предоставляем вам возможность проводить тестовые платежи в режиме песочницы.

Sandbox-процессинг – это игровая песочница для проведения тестов при интеграции с системой ACQUIRO. Sandbox-процессинг использует специальные номер карт, предназначенных только для целей тестирования:

4000 0000 0000 0002 – эмулируется удачное прохождение платежа для любой суммы платежа с возможностью полной или частичной отмены платежа (согласно настройкам).

4111 1111 1111 1111 – эмулируется отмена транзакции Процессингом Банка.

Любые иные номера карт приводят к отмене платежа.

Для любого из вышеперечисленных номеров:

expiration date – дата истечения срока действия карты, должна быть хотя бы на 1 месяц больше текущего месяца.

CVC2/CVV2 – любые 3 цифры.

Убедиться в правильности выбранной модели проведения платежа можно, совершив успешный тестовый платеж. В списке транзакций в личном кабинете AcruiroPay вы должны увидеть вашу транзакцию со статусом PRE (Preautorization - Преавторизация).

После проведения операции подтверждения (списания) по такому заказу в личном кабинете SLETAT.RU такой платеж будет отображаться в кабинете AcquiroPay уже со статусом CAP (Capture - Списание):

Если вы увидели в своих транзакциях наличие статуса PUR (Purchase - Оплата), то это является признаком неверной настройки модели проведения платежа. В таком случае у вас, скорее всего, включена одностадийная модель проведения платежа. Если это так, попросите менеджера AcquiroPay поменять вам модель на двухстадийную (Предавторизация - Списание).