Узнайте, как продавцы интегрируют платежные приложения и как работают транзакции с Payment Request API.
Web Payments API – это специальные платежные функции, впервые встроенные в браузер. Web Payments упрощает интеграцию платежных приложений для продавцов, а также делает процесс оплаты более удобным и безопасным для покупателей.
Чтобы узнать больше о преимуществах использования Web Payments, ознакомьтесь со статьей Расширение возможностей платежных приложений с помощью Web Payments.
В этой статье мы рассмотрим платежную транзакцию на сайте продавца и расскажем, как работает интеграция платежного приложения.
Процесс состоит из шести этапов:
- Продавец инициирует платежную транзакцию.
- Продавец показывает кнопку оплаты.
Пользователь нажимает кнопку оплаты.
Браузер запускает платежное приложение.
Если клиент меняет какие-либо данные (например, способ доставки или адрес), продавец обновляет сведения о транзакции, отражающие это изменение.
После того как клиент подтвердит покупку, продавец проверяет платеж и завершает транзакцию.
Шаг 1. Продавец инициирует платежную транзакцию
Когда клиент решает совершить покупку, продавец инициирует платежную транзакцию, создавая объект PaymentRequest. Этот объект содержит важную информацию о транзакции:
- Допустимые способы оплаты и данные, необходимые для обработки транзакции.
- Подробные сведения, например общая цена (обязательно) и информация о товарах.
- Параметры, с помощью которых продавцы могут запрашивать информацию о доставке, например адрес и способ доставки.
- Продавцы также могут запрашивать платежный адрес, имя плательщика, адрес электронной почты и номер телефона.
- Продавцы также могут указать необязательный атрибут тип доставки (
shipping,deliveryилиpickup) в атрибутеPaymentRequest. Платежное приложение может использовать это как подсказку для отображения правильных ярлыков в своем пользовательском интерфейсе.
const request = new PaymentRequest([{
supportedMethods: 'https://bobpay.xyz/pay',
data: {
transactionId: '****'
}
}], {
displayItems: [{
label: 'Anvil L/S Crew Neck - Grey M x1',
amount: { currency: 'USD', value: '22.15' }
}],
total: {
label: 'Total due',
amount: { currency: 'USD', value : '22.15' }
}
}, {
requestShipping: true,
requestBillingAddress: true,
requestPayerEmail: true,
requestPayerPhone: true,
requestPayerName: true,
shippingType: 'delivery'
});
Некоторые обработчики платежей могут потребовать от продавца предоставить идентификатор транзакции, который они выдали заранее, как часть информации о транзакции. Обычно интеграция включает обмен данными между сервером продавца и сервером обработчика платежей для резервирования общей суммы. Это не позволяет злоумышленникам манипулировать ценой и обманывать продавца, поскольку в конце транзакции выполняется проверка.
Продавец может передать идентификатор транзакции в свойстве data объекта PaymentMethodData.
Получив информацию о транзакции, браузер выполняет поиск платежных приложений, указанных в PaymentRequest, на основе идентификаторов способов оплаты. Это позволяет браузеру определить, какое платежное приложение нужно запустить, как только продавец будет готов к транзакции.
Подробнее о том, как настроить способ оплаты…
Шаг 2. Продавец показывает кнопку оплаты
Продавцы могут поддерживать множество способов оплаты, но должны показывать только те кнопки, которые покупатель может использовать. Показ неработающей кнопки оплаты ухудшает пользовательский опыт. Если продавец может предсказать, что способ оплаты, указанный в объекте PaymentRequest, не сработает для клиента, он может предоставить резервное решение или вообще не показывать эту кнопку.
С помощью экземпляра PaymentRequest продавец может узнать, доступно ли клиенту платежное приложение.
Есть ли у клиента платежное приложение?
Метод canMakePayment() объекта PaymentRequest возвращает значение true, если на устройстве клиента доступно платежное приложение. "Доступно" означает, что обнаружено платежное приложение, поддерживающее способ оплаты, и что установлено платежное приложение для конкретной платформы или веб-версия платежного приложения готово к регистрации.
const canMakePayment = await request.canMakePayment();
if (!canMakePayment) {
// Fallback to other means of payment or hide the button.
}
Шаг 3. Клиент нажимает кнопку оплаты
Когда клиент нажимает кнопку оплаты, продавец вызывает метод show() экземпляра PaymentRequest, который сразу же запускает интерфейс оплаты.
Если итоговая цена определяется динамически (например, запрашивается с сервера), продавец может отложить запуск интерфейса оплаты до тех пор, пока не будет известна итоговая сумма.
Отложенный запуск интерфейса оплаты
Посмотрите демонстрацию отложенного показа интерфейса оплаты до определения итоговой цены.
Чтобы отложить показ интерфейса оплаты, продавец передает обещание методу show().
Браузер будет показывать индикатор загрузки, пока промис не будет выполнен и транзакция не будет готова к началу.
const getTotalAmount = async () => {
// Fetch the total amount from the server, etc.
};
try {
const result = await request.show(getTotalAmount());
// Process the result…
} catch(e) {
handleError(e);
}
Если в качестве аргумента для show() не указан объект Promise, браузер сразу же запустит интерфейс оплаты.
Шаг 4. Браузер запускает платежное приложение
Браузер может запустить платежное приложение для определенной платформы или веб-версию. Подробнее о том, как Chrome определяет, какое платежное приложение запустить…
Разработчик может создать платежное приложение по своему усмотрению, но события, передаваемые продавцу и от него, а также структура данных, передаваемых вместе с этими событиями, стандартизированы.
При запуске платежное приложение получает информацию о транзакции, переданную объекту PaymentRequest на шаге 1. Она включает в себя следующее:
- Данные о способе оплаты
- Итоговая цена
- Способы оплаты
Платежное приложение использует информацию о транзакции для маркировки своего пользовательского интерфейса.
Шаг 5. Как продавец может обновить сведения о транзакции в зависимости от действий клиента
Клиенты могут изменить сведения о транзакции, например способ оплаты и доставки, в платежном приложении. Когда клиент вносит изменения, продавец получает уведомления об этом и обновляет сведения о транзакции.
Продавцы могут получать события четырех типов:
- Событие изменения способа оплаты
- Событие изменения адреса доставки
- Событие изменения варианта доставки
- Событие проверки продавца
Событие изменения способа оплаты
Платежное приложение может поддерживать несколько способов оплаты, и продавец может предлагать специальную скидку в зависимости от выбора клиента. Чтобы учесть этот сценарий, событие изменения способа оплаты может сообщить продавцу о новом способе оплаты, чтобы он мог обновить общую цену со скидкой и вернуть ее обратно в платежное приложение.
request.addEventListener('paymentmethodchange', e => {
e.updateWith({
// Add discount etc.
});
});
Событие изменения адреса доставки
Платежное приложение может предоставлять адрес доставки клиента. Это удобно для клиентов, поскольку им не нужно вручную вводить какие-либо данные в форму и они могут хранить свой адрес доставки в предпочитаемых ими платежных приложениях, а не на нескольких разных сайтах продавцов.
Если клиент обновляет адрес доставки в платежном приложении после начала транзакции, продавцу отправляется событие 'shippingaddresschange'. Это событие помогает продавцу определить стоимость доставки на основе нового адреса, обновить общую цену и вернуть ее в платежное приложение.
request.addEventListener('shippingaddresschange', e => {
e.updateWith({
// Update the details
});
});
Если продавец не может доставить товар по новому адресу, он может отправить сообщение об ошибке, добавив параметр ошибки в сведения о транзакции, возвращаемые платежному приложению.
Событие изменения варианта доставки
Продавец может предложить покупателю несколько вариантов доставки и делегировать выбор платежному приложению. Варианты доставки отображаются в виде списка цен и названий служб, из которых покупатель может выбрать подходящий. Пример:
- Стандартная доставка – бесплатно
- Экспресс-доставка – 5 долларов США.
Когда клиент обновляет способ доставки в платежном приложении, продавцу отправляется событие 'shippingoptionchange'. Затем продавец может определить стоимость доставки, обновить общую цену и вернуть ее в платежное приложение.
request.addEventListener('shippingoptionchange', e => {
e.updateWith({
// Update the details
});
});
Продавец также может динамически изменять варианты доставки в зависимости от адреса доставки клиента. Это удобно, если вы хотите предлагать разные варианты доставки для покупателей из своей страны и из-за рубежа.
Событие проверки продавца
Для дополнительной безопасности платежное приложение может выполнить проверку продавца перед переходом к оплате. Разработчики платежного приложения сами выбирают, как будет работать механизм проверки, но событие проверки продавца сообщает продавцу URL, который можно использовать для проверки.
request.addEventListener('merchantvalidation', e => {
e.updateWith({
// Use `e.validateURL` to validate
});
});
Шаг 6. Продавец подтверждает платеж и завершает транзакцию
Когда клиент авторизует платеж, метод show() возвращает объект Promise, который распознается как PaymentResponse.
Объект PaymentResponse содержит следующую информацию:
- Сведения о результате платежа
- Адрес доставки
- Вариант доставки
- Контактная информация
В этот момент в интерфейсе браузера может по-прежнему отображаться индикатор загрузки, означающий, что транзакция ещё не завершена.
Если платежное приложение закрывается из-за ошибки или сбоя оплаты, обещание, возвращенное из show(), отклоняется, и браузер завершает платежную транзакцию.
Обработка и подтверждение платежа
Объект details в PaymentResponse – это платежные данные, возвращенные платежным приложением. Продавец может использовать их для обработки или подтверждения платежа. Как именно это происходит, зависит от обработчика платежей.
Завершение или повтор транзакции
После того как продавец определит, была ли транзакция успешной, он может:
- Вызовите метод
.complete(), чтобы завершить транзакцию и закрыть индикатор загрузки. - Позвольте клиенту повторить попытку, вызвав метод
retry().
async function doPaymentRequest() {
try {
const request = new PaymentRequest(methodData, details, options);
const response = await request.show();
await validateResponse(response);
} catch (err) {
// AbortError, SecurityError
console.error(err);
}
}
async function validateResponse(response) {
try {
const errors = await checkAllValuesAreGood(response);
if (errors.length) {
await response.retry(errors);
return validateResponse(response);
}
await response.complete("success");
} catch (err) {
// Something went wrong…
await response.complete("fail");
}
}
// Must be called as a result of a click
// or some explicit user action.
doPaymentRequest();
Дальнейшие действия
- Подробнее о том, как объявить идентификатор способа оплаты…
- Узнайте, как создать платежное приложение для определенной платформы, в руководстве для разработчиков платежных приложений Android.
- Подробнее о том, как создать веб-приложение для платежей, рассказывается в руководстве для разработчиков.