Использование виджетов для платежей АПК Ассист

Использование виджета Apple Pay для платежей АПК Ассист

Общие сведения

Виджет Apple Pay позволяет покупателям использовать Apple Wallet для оплаты в интернет-магазине без переадресации на внешние платежные страницы и без ввода данных банковской карты.

Apple Pay поддерживается на устройствах iOS и macOS.

Визуально виджет представлен в виде кнопки Apple Pay, нажатие на которую запускает процесс авторизации и оплаты заказа.

Порядок действий при оплате с помощью виджета

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

Список действий для организации оплат с помощь виджета

Для организации оплат с помощь виджета на странице интернет-магазина необходимо выполнить следующие подготовительные шаги:

оформить заявку на подключение оплаты Apple Pay в АПК Ассист;
пройти регистрацию в Apple;
создать сертификат в Личном кабинете предприятия;
подписать полученный сертификат;
загрузить подписанный сертификат в Личном кабинете предприятия;
подготовить страницы интернет-магазина для оплаты;
- обязательны использование протокола https на странице с виджетом и поддержка протокола TLS версии 1.2;
- домен должен иметь действующий SSL сертификат.

Размещение виджета на странице интернет-магазина

Для размещения виджета на странице интернет-магазина следует выполнить следующие действия:

поместить виджет на страницу оплаты интернет-магазина;
настроить виджет;
проверить возможность оплаты с помощью виджета;
- передать параметры заказа;
- получить и обработать результат оплаты.

Описание виджета

Виджет представляет собой HTML-код и JS-скрипт, которые необходимо разместить и настроить на странице оплаты интернет-магазина.

Установка виджета

В том месте страницы интернет-магазина, на которой планируется разместить кнопку оплаты Apple Pay, необходимо добавить следующий код:

<button id="apple-pay-button"></button>

Для кнопки можно задать цвет, тип и размеры. Примеры типов кнопок и их описание доступны на сайте https://developer.apple.com/design/human-interface-guidelines/apple-pay/overview/buttons-and-marks/.

Для настройки внешнего вида кнопки необходимо добавить описание стиля в теге <head></head>.

<style>
  #apple-pay-button {
    display: none;
    background-color: black;
    background-image: -webkit-named-image(apple-pay-logo-white);
    background-size: 100% 100%;
    background-origin: content-box;
    background-repeat: no-repeat;
    width: 100%;
    height: 44px;
    padding: 10px 0;
    border-radius: 10px;
  }
</style>

Подробнее о настройке внешнего вида кнопки см. https://developer.apple.com/documentation/apple_pay_on_the_web/displaying_apple_pay_buttons.

Передача параметров заказа

После нажатия на кнопку Apple Pay на странице интернет магазина создается сессия applePaySession, в которую нужно передать параметры заказа.

В качестве параметров заказа следует передать сумму и валюту заказа, а также поддерживаемые типы карт.

    Const currency = $('#currency').val(); // валюта
    Const paymentRequest = {
      countryCode: region.toUpperCase(),
      currencyCode: currency.toUpperCase(),
      total: {
        label: 'Your label', // название платежа
        amount: $('#amount').val() //сумма заказа
      },
      supportedNetworks:['masterCard', 'visa'],
      merchantCapabilities: [ 'supports3DS' ] //поддерживаемые карты
    };
Const applePaySession = new window.ApplePaySession(1, paymentRequest);

Для обработки сессии используются два метода:

onvalidatemerchant;
onpaymentauthorizad.

В методе onvalidatemerchant осуществляется проверка платежной сессии, метод выполняется при отображении всплывающего окна Apple Pay.

Метод onpaymentauthorizad выполняется при подтверждении операции оплаты. В метод передается платежный токен, полученный от Apple Pay, а также параметры заказа.

Список параметров заказа

Параметр	Описание
merchant_id	Идентификатор интернет-магазина
amount	Сумма заказа в единицах валюты
currency	Валюта заказа
ordernumber	Уникальный номер заказа на стороне интернет-магазина
comment	Комментарий
email	Email покупателя
firstname	Имя покупателя
lastname	Фамилия покупателя
middlename	Отчество покупателя

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

var data = {
            token : event.payment.token,
            merchant_id : $('#merchant_id').val(),
            email : $('#email').val(),
            amount : $('#amount').val(),
            currency : $('#currency').val(),
            ordernumber : $('#ordernumber').val(),
            email : $('#email').val(),
            firstname : $('#firstname').val(),
            middlename : $('#middlename').val(),
            lastname : $('#lastname').val(),
            comment : $('#comment').val()
};

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

$.post("/pay/tokenpay_widget_ap.cfm", JSON.stringify(data)).then(function (result) {
  //пример обработки платежа:
  if (!result.hasOwnProperty('firstcode') && JSON.stringify(result.order.orderstate) == '"Approved"' && JSON.stringify(result.order.orderstate) == '"Delayed"') {
    applePaySession.completePayment(ApplePaySession.STATUS_SUCCESS);
  } else {
    applePaySession.completePayment(ApplePaySession.STATUS_FAILURE);
  }
});

Если по каким-то причинам оплата заказа прошла неуспешно, то сервис вернет сообщения об ошибках (ненулевые значения параметров firstcode, secondcode).

Скрипт использует Apple Pay API, который поддерживается:

iOS 10+ в браузере Safari и в объектах SFSafariViewController, а также на моделях iPhone с помощью Secure Element (SE и 6+);
macOS 10.12+ в браузере Safari на компьютерах с Touch ID (MacBook Pro) или при подключенном iPhone или Apple Watch для подтверждения платежей.

Пример скрипта

Ниже приведен пример скрипта виджета, который может быть размещен на платежной странице интернет-магазина.

<script type="text/javascript">
document.addEventListener('DOMContentLoaded', function(){
    if (window.ApplePaySession) {
        //проверка возможности оплаты и отображение кнопки Apple Pay
        if (ApplePaySession.canMakePayments) {
            document.getElementById('apple-pay-button').style.display = 'block';
            document.getElementById('apple-pay-button').addEventListener('click', applePayButtonClicked);
        }
    } else {console.log("ApplePaySession not available"); }
});
 
function applePayButtonClicked() {
    const region = 'RU';
    const currency = $('#currency').val();//валюта заказа
    const paymentRequest = {
        countryCode: region.toUpperCase(),
        currencyCode: currency.toUpperCase(),
        total: {
            label: 'Your label', //название платежа
            amount: $('#amount').val()//сумма заказа
        },
        supportedNetworks:['masterCard', 'visa'],
        merchantCapabilities: [ 'supports3DS' ]
    };
    const version = window.ApplePaySession.supportsVersion(3)
                    ? 3
                    : window.ApplePaySession.supportsVersion(2)
                    ? 2 : 1;
    const applePaySession = new window.ApplePaySession(version, paymentRequest);
    console.log("start session");
 
    // обработчик события для создания merchant session.
    applePaySession.onvalidatemerchant = function (event) {
        console.log("onvalidatemerchant in");
        var data = {
            validationUrl: event.validationURL
        };
        console.log(JSON.stringify(data));
 
        // отправка запроса на сервер предприятия, далее запрос API для запуска сессии
        $.post("/pay/apple_pay_comm.cfm", data).then(function (result) {
            applePaySession.completeMerchantValidation(result);
        });
    }
 
  // обработчик события авторизации платежа
    applePaySession.onpaymentauthorized = function (event) {
        console.log("onpaymentauthorized in");
        //var email = event.payment.shippingContact.emailAddress; //если был запрошен адрес e-mail
        //var phone = event.payment.shippingContact.phoneNumber; //если был запрошен телефон
        //все варианты на сайте https://developer.apple.com/reference/applepayjs/paymentcontact
 
        // передача параметров заказа
        var data = {
            token : event.payment.token,
            merchant_id : $('#merchant_id').val(),
            email : $('#email').val(),
            amount : $('#amount').val(),
            currency : $('#currency').val(),
            ordernumber : $('#ordernumber').val(),
            email : $('#email').val(),
            firstname : $('#firstname').val(),
            middlename : $('#middlename').val(),
            lastname : $('#lastname').val(),
            comment : $('#comment').val()
        };
        //отправка запроса на сервер предприятия, далее запрос API для проведения оплаты
        console.log(JSON.stringify(event.payment.token));
        $.post("/pay/tokenpay_widget_ap.cfm", JSON.stringify(data)).then(function (result) {
            if (!result.hasOwnProperty('firstcode') && JSON.stringify(result.order.orderstate) == '"Approved"' && JSON.stringify(result.order.orderstate) == '"Delayed"') {
            applePaySession.completePayment(ApplePaySession.STATUS_SUCCESS);
            } else {
            applePaySession.completePayment(ApplePaySession.STATUS_FAILURE);
            }
        });
    };
    applePaySession.begin();
}
 
</script>
<style>
  #apple-pay-button {
    display: none;
    background-color: black;
    background-image: -webkit-named-image(apple-pay-logo-white);
    background-size: 100% 100%;
    background-origin: content-box;
    background-repeat: no-repeat;
    width: 100%;
    height: 44px;
    padding: 10px 0;
    border-radius: 10px;
  }
</style>

Использование виджета Google Pay для платежей АПК Ассист

Общие сведения

Виджет Google Pay позволяет покупателям - клиентам Google осуществлять оплату в интернет-магазине без переадресации на внешние платежные страницы и без ввода данных банковской карты.

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

Использование виджета Google Pay позволяет осуществлять оплату как обычными картами, привязанными к аккаунту Google, так и токенизированными картами Google Pay. При этом на устройствах без установленного приложения Google Pay покупателю будет предложено выбрать сохраненную карту из Google.

Google Pay работает с картами Visa и MasterCard.

Порядок действий при оплате с помощью виджета

Покупатель выбирает товары на сайте интернет-магазина.
Интернет-магазин передает данные заказа в виджет.
Покупатель нажимает кнопку оплаты Google Pay.
Открывается специальный диалог браузера, в котором можно выбрать одну из карт, привязанных ранее.
Покупатель выбирает карту и подтверждает оплату на устройстве.
Приложение Google Pay формирует зашифрованный пакет с токеном.
Виджет получает пакет с токеном от Google Pay.
Виджет передает зашифрованный пакет с токеном и данными платежа АПК Ассист.
АПК Ассист расшифровывает пакет с токеном и данными платежа.
АПК Ассист проводит оплату токеном через процессинг расчётного банка.
АПК Ассист возвращает результаты проведения оплаты интернет-магазину.
Интернет-магазин отображает результат оплаты для покупателя.

Список действий для организации оплат с помощь виджета

Для организации оплат с помощь виджета на странице интернет-магазина необходимо выполнить следующие подготовительные шаги:

оформить заявку на подключение оплаты Google Pay в АПК Ассист;
пройти регистрацию в Google и заполнить форму регистрации https://services.google.com/fb/forms/googlepayAPIenable/;
проверить выполнение требований по брендированию Google;
подтвердить домен в Google;
подготовить страницы интернет-магазина для оплаты;
- обязательно использование протокола https на странице с виджетом;
- домен должен иметь действующий TSL сертификат.

При использовании необходимо учитывать требования Google https://payments.developers.google.com/terms/sellertos, включая список запрещенных товаров и услуг https://payments.developers.google.com/terms/aup, а также требования к брендированию https://developers.google.com/pay/api/web/guides/brand-guidelines.

Размещение виджета на странице интернет-магазина

Для размещения виджета на странице интернет-магазина следует выполнить следующие действия:

поместить виджет на страницу оплаты интернет-магазина;
настроить виджет;
проверить возможность оплаты с помощью виджета;
- передать параметры заказа;
- получить и обработать результат оплаты.

Описание виджета

Виджет представляет собой HTML-код и JS-скрипт, которые необходимо разместить и настроить на странице оплаты интернет-магазина.

Установка виджета

В том месте страницы интернет-магазина, на которой планируется разместить кнопку оплаты Google Pay, необходимо добавить следующий код:

<div id="container"></div>

В теге id="container" будет размещена кнопка оплаты Google Pay. При необходимости идентификатору тега можно присвоить другое значение. Для этого следует внести соответствующие изменения в метод createButton функции addGooglePayButton, например:

document.getElementById('mynewcontainer').style.display = 'block'; //mynewcontainer — новое название тега

Дополнительно на той же странице необходимо подключить JS-скрипт для вызова Google Pay API и JS-скрипт оплаты.

<script async src="https://pay.google.com/gp/p/js/pay.js" onload="onGooglePayLoaded()"></script>

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

Для настройки окружения следует задать параметр environment в функции getGooglePaymentsClient. Для работы с реальными данными нужно указать значение ’PRODUCTION’, а для тестирования – значение ’TEST’.

function getGooglePaymentsClient() {
  if ( paymentsClient === null ) {
  paymentsClient = new google.payments.api.PaymentsClient({environment: 'TEST'});
  }
  Return paymentsClient;
}

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

«PAN_ONLY» - аутентификация карт, сохраненных в аккаунте Google;

«CRYPTOGRAM_3DS» - аутентификация карт, хранящихся в виде токенов Google Pay, используется только на мобильных устройствах с установленным приложением Google Pay.

const allowedCardAuthMethods = ["PAN_ONLY", "CRYPTOGRAM_3DS"];

Также следует определить, карты каких платежных систем будут приниматься к оплате в интернет-магазине. Для этого предназначен параметр allowedCardNetworks:

const allowedCardNetworks = ["MASTERCARD", "VISA"];

Теперь нужно вставить идентификатор интернет-магазина в скрипт виджета (параметр gatewayMerchantId):

const tokenizationSpecification = {
  type: 'PAYMENT_GATEWAY',
  parameters: {
    'gateway': 'assist',
    'gatewayMerchantId': '02510116604241796260'
  }
}

Content

Space Tools

Использование виджетов для платежей АПК Ассист

Использование виджета Apple Pay для платежей АПК Ассист

Общие сведения

Порядок действий при оплате с помощью виджета

Список действий для организации оплат с помощь виджета

Размещение виджета на странице интернет-магазина

Описание виджета

Установка виджета

Передача параметров заказа

Пример скрипта

Использование виджета Google Pay для платежей АПК Ассист

Общие сведения

Порядок действий при оплате с помощью виджета

Список действий для организации оплат с помощь виджета

Размещение виджета на странице интернет-магазина

Описание виджета

Установка виджета

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