Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Cкрытый режим платежа, при котором все данные о заказе, о покупателе, о способе оплаты и платежном средстве передаются непосредственно предприятием, может быть выполнен с использованием карты или токена.

1. Оплата с использованием карты

1.1. Передача параметров платежа

Для работы в данном режиме предусмотрен web-сервис silentpay.

...

В случае неуспешной оплаты responsecode принимает значения AS100-AS998 (кроме специального кода AS110, если необходима авторизация по 3-D Secure, подробнее см. п. 1.4).

Если запрос на оплату не может быть обработан, в результате вернутся ненулевые значения параметров firstcode, secondcode.

...

С описанием первого и второго кодов автоматизированных интерфейсов можно ознакомиться здесь.

1.2. Рекуррентный платеж

Сервис предназначен для инициации оплаты за продолжение предоставления услуг по подписке. Данная возможность допустима для оплат, проводимых через процессинг UCS.

...

В качестве значения поля <meannumber> возвращаются первые 6 и последние 4 цифры номера карты, остальные цифры скрыты символом *.

1.3. Дополнительные параметры (для СПМ)

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

...

Название

Принимаемые значения

Описание

HEADER_HTTP_USER_AGENT

Строковый (255 байт)

Заголовок http запроса USER-AGENT

HEADER_HTTP_ACCEPT

Строковый (255 байт)

Заголовок http запроса ACCEPT

HEADER_HTTP_ACCEPT_LANGUAGE

Строковый (128 байт)

Заголовок http запроса ACCEPT-LANGUAGE

HEADER_HTTP_REFERER

Строковый (255 байт)

Заголовок http запроса REFERER

HEADER_REMOTE_HOST

Строковый (16 символов)

Переменная окружения REMOTE_ADDRESS.

HEADER_HTTP_FORWARDED

Строковый (16 байт)

Заголовок http запроса FORWARDED

HEADER_HTTP_X_FORWARDED_FOR

Строковый (16 байт)

Заголовок http запроса FORWARDED-FOR

HEADER_HTTP_VIA

Строковый (128 байт)

Заголовок http запроса VIA

CLIENT_JS_VER

Строковый (16 символов)

при помощи JS

CLIENT_LOCAL_TIME

Строковый (128 символов)

при помощи JS

CLIENT_SCREEN_RES

Строковый (16 символов)

Screen.width + 'x' + screen.height

CLIENT_SCREEN_COLORS

Числовой (15)

Screen.pixelDepth

CLIENT_JS_BROWSER_NAME

Строковый (255 символов)

navigator.appName

CLIENT_TIME_ZONE

Числовой (5)

Временная зона в часах.

Формула перевода: (-GMT_H). Например, GMT +2 будет соответствовать значению -2.

CLIENT_COOKIES

Строковый (16 символов)


CLIENT_JAVA

Логическое (true, false)

navigator.javaEnabled()

CLIENT_STYLESHEETS

Логическое (true, false)

Document.stylesheet.disabled

CLIENT_BROWSER_PLATFORM

Строковый (64 символа)

navigator.platform

CLIENT_SYSTEM_LANGUAGE

Строковый (5 байт)

navigator.systemLanguage

CLIENT_BROWSER_LANGUAGE

Строковый (5 байт)

navigator. language

CLIENT_USER_LANGUAGE

Строковый (5 байт)

navigator. userLanguage

CLIENT_PROCESSOR

Строковый (16 символов)

navigator.cpuClass

CLIENT_CONNECTION

Строковый (16 символов)

navigator.connectionType

CLIENT_HOSTADDRESS

Строковый (16 символов)

Вычисленный на базе HOST_ADDRESS и DNS lookup

CLIENT_HOSTNAME

Строковый

(70 символов)

Переменная окружения HOST_ADDRESS

Anchor
4
4


1.4. 3D-Secure авторизация

Для магазинов, работающих по режиму silentpay, реализована возможность оплаты по картам, требующим 3D-Secure авторизации (в случае, если у магазина и процессинга выполнены соответствующие настройки).

...

Code Block
languagexml
<?xml version="1.0" encoding="windows-1251" standalone="no" ?> 
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<SOAP-ENV:Body SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Fault>
<faultcode>Первый код</faultcode> 
<faultstring>Второй код</faultstring> 
<detail />
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Anchor
tokenshop
tokenshop


2. Оплата с использованием токена

2.1. Оплата токеном в браузере на стороне магазина

При проведении оплаты токеном Google Pay в браузере на стороне магазина выполняются следующие действия:

...

  1. Покупатель выбирает товары на сайте интернет-магазина и нажимает кнопку оплаты Google Pay (доступно в браузерах с поддержкой Payment Request API на мобильных устройствах).
  2. После нажатия кнопки оплаты через Google Pay осуществляется вызов Payment Request API и передача сертификата с публичным ключом Ассист.
  3. Открывается специальный диалог браузера, в котором можно выбрать одну из карт, привязанных в мобильном приложении Google Pay.
  4. После выбора карты покупателю предлагается приложить палец к считывателю для подтверждения платежа. 
  5. Приложение Google Pay формирует зашифрованный пакет с токеном и данными платежа и возвращает его скрипту страницы магазина.
  6. Зашифрованный пакет с токеном и данными платежа передается в сервис TokenPay АПК Ассист. 
  7. АПК Ассист расшифровывает пакет с токеном и данными платежа.
  8. АПК Ассист проводит оплату токеном через процессинг расчётного банка.
  9. АПК Ассист возвращает результаты проведения оплаты интернет-магазину.

...

  1. Покупатель выбирает товары на сайте интернет-магазина и нажимает кнопку оплаты Apple Pay (доступно только в браузере Safari на платформе MacOS).
  2. После нажатия кнопки оплаты через Apple Pay осуществляется вызов Payment Request API и передача сертификата с публичным ключом мерчанта. Одновременно открывается специальный диалог, в котором можно будет выбрать одну из карт, привязанных в мобильном приложении Apple Pay.
  3. После выбора карты покупателю направляется PUSH уведомление на iPhone и предлагается приложить палец к считывателю для подтверждения платежа.
  4. Приложение Apple Pay формирует зашифрованный пакет с токеном и данными платежа и возвращает его скрипту страницы магазина.
  5. Зашифрованный пакет с токеном и данными платежа передается в сервис TokenPay АПК Ассист.
  6. АПК Ассист расшифровывает пакет с токеном и данными платежа.
  7. АПК Ассист проводит оплату токеном через процессинг расчётного банка.
  8. АПК Ассист возвращает результаты проведения оплаты интернет-магазину.

...

  • сделать заявку для подключения платёжных средств для оплаты токенами (Apple Pay, Google Pay) в службу технической поддержки АПК Ассист support@assist.ru;
  • интегрировать в код своей страницы:
    • для получения шифрованного пакета с токеном и данными платежа:
      • Payment Request API для Google Pay;
      • ApplePay JS API для Apple Pay;
    • для проведения оплаты – обращение к сервису TokenPay;
  • получить подтверждение от службы технической поддержки АПК Ассист о том, что все необходимые технические настройки для приёма платежей токенами при оплате товаров и услуг данному предприятию выполнены;
  • подготовиться к приему платежей:
  • при использовании Apple Pay создать и подписать сертификат Apple Pay для выполнения платежей с помощью соответствующего раздела в ЛК АПК Ассист;
  • при использовании Google Pay для организации схемы шифрования токена следует применять публичный ключ Public Key: 'BElVf3z1PE68riWbP0YRp4vC+0MuNbd6pqVAe1uHBHYGJvzZonlkVAp5CEEp2EEUswS7hS1y0RyNB3SR2FVExDQ=' и идентификатор мерчанта MerchantID:'16590966430175452581'.

Anchor
tokenpay
tokenpay


2.2. Передача платежной информации TokenPay

Для передачи зашифрованного блока данных о платеже нужно отправить запрос на сервер АПК Ассист методом HTTP POST (в кодировке UTF-8).

...

Дополнительно можно ознакомиться с вариантами организации платежей токенами с использованием разных провайдеров.

Наверх