Реализация платежей в OutlookImplementing payments in Outlook

Реализация платежей в Outlook предоставляет эффективное решение, с помощью которого вы сможете отправлять платежные требования по электронной почте, а получатель — немедленно их удовлетворять.Implementing payments in Outlook provides a powerful payment solution that allows you to send requests for payments via email that are immediately actionable by the recipient. В Outlook получатель может просмотреть счет, выбрать метод оплаты и утвердить платеж.The recipient can view their invoice, select a payment method, and approve payment, all from within Outlook.

Давайте рассмотрим простой сценарий выставления счета и его оплаты.Let's take a look at the flow for a simple invoice scenario.

Последовательность событий при отправке счета и получении платежаSequence of events for sending an invoice and receiving payment

Блок-схема последовательности событий при отправке счета и получении платежа через Outlook

  1. Продавец отправляет электронное письмо с платежным требованием получателю в Office 365.The merchant sends a payment request email to the recipient on Office 365.
  2. Перед доставкой платежная служба проверяет, разрешено ли продавцу отправлять платежные требования.The payment service validates that the sender is allowed to send payment requests before delivering to the user.
  3. Пользователь открывает сообщение, отображаемое в виде платежной карточки.The user opens the message, which is rendered as a payment card.
  4. Пользователь инициирует оплату на карточке.The user invokes the payment action on the card.
  5. Платежная служба отправляет POST-запрос на сервер продавца, чтобы получить реквизиты и разрешенные методы оплаты.The payment service POSTs a request to the merchant's server to get the invoice details and allowed payment methods.
  6. Используя сведения из POST-запроса, продавец получает счет и отправляет его обратно в Outlook.The merchant uses the information in the POST to retrieve the invoice and sends it back to Outlook.
  7. Пользователь проверяет счет, выбирает метод оплаты и утверждает платеж, не выходя из Outlook.The user reviews the invoice, selects a payment method, and approves payment without leaving Outlook.
  8. Платежная служба отправляет маркер платежа в POST-запросе на сервер продавца.The payment service POSTs a payment token to the merchant's server.
  9. Продавец обрабатывает маркер, используя соответствующий API обработчика платежей (Stripe, Microsoft Pay и т. д.) и отправляет результат в Outlook.The merchant processes the token using the appropriate payment processor API (Stripe, Microsoft Pay, etc.) and sends the result back to Outlook.
  10. Outlook показывает результат.Outlook displays the result.

Компоненты интеграцииIntegration components

Интеграция платежей в Outlook состоит из двух основных частей.There are two major components to creating a payment integration in Outlook.

  • Сообщение с платежным требованием. Это сообщение электронной почты с действиями, связанными с оплатой.Payment request message - This is an email message that includes pay-specific actions. Ваша служба отправляет эти сообщения особого формата получателю.Your service sends these specially-formatted messages to the recipient.
  • Служба веб-перехватчиков. Это веб-служба, в которой реализованы два отдельных веб-перехватчика: один предоставляет актуальную информацию о счете или оформлении заказа, а второй принимает платежи.Webhook service - This is a web service that implements two distinct webhooks: one that provides up-to-date invoice or checkout information, and one that accepts payment.

Сообщение с платежным требованиемPayment request message

Сообщение с платежным требованием — это сообщение электронной почты, в HTML-текст которого внедрена карточка с действиями.The payment request message is an email message with an actionable card embedded in the HTML body. Карточка определяется полезными данными JSON, как указано в справочных материалах по разметке ActionRequest.The card is defined by a JSON payload as specified in ActionRequest markup reference.

Снимок экрана сообщения с платежным требованием в Outlook

Полезные данные ActionRequest содержат словарь JSON productContext, в котором должна быть информация, необходимая веб-перехватчикам для поиска соответствующего счета.The ActionRequest payload contains a productContext JSON dictionary, which should include the information your webhooks need to locate the corresponding invoice.

Важно!

Чтобы отправлять сообщения с платежным требованием другим пользователям, необходимо зарегистрировать службу на информационной панели разработчика.The ability to send actionable messages to other users requires registration with the actionable email developer dashboard. Для разметки платежной карты также требуется идентификатор продавца и отображаемый идентификатор, созданные на информационной панели партнера, которая предназначена для платежей в Outlook.The payment card markup also requires a merchant ID and display ID generated by the partner dashboard for payments in Outlook. Дополнительные сведения см. в статье Начало работы с платежами в Outlook.For details, see Get started with payments in Outlook.

Веб-перехватчикиWebhooks

В веб-службе реализованы два отдельных веб-перехватчика.The web service implements two distinct webhooks.

  • Веб-перехватчик платежного требования: этот веб-перехватчик получает POST-запросы на загрузку счетов.Payment request webhook: this webhook receives POSTs to load invoices. Если используемый вами сценарий предусматривает запрос адреса и способа доставки, этот веб-перехватчик также получает POST-запросы, когда пользователь выбирает или изменяет информацию о доставке.If your invoicing scenario includes prompting for a shipping address and shipping option, this webhook also receives POSTs when the user selects or changes their shipping information. Этот веб-перехватчик возвращает актуальный счет для отображения в Outlook.This webhook returns an up-to-date invoice to be displayed in Outlook. Дополнительные сведения см. в статье Веб-перехватчик PaymentRequest.For details, see PaymentRequest webhook.
  • Веб-перехватчик осуществления платежа: этот веб-перехватчик получает POST-запросы с маркерами платежей.Payment complete webhook: this webhook receives POSTs with payment tokens. Этот веб-перехватчик обрабатывает маркеры платежей и возвращает сведения об успешном или неуспешном выполнении в Outlook.This webhook processes payment tokens and returns success or failure to Outlook. Дополнительные сведения см. в статье Веб-перехватчик PaymentComplete.For details, see PaymentComplete webhook.

Дальнейшие действияNext steps

Ознакомьтесь с нашим руководством, чтобы узнать, как реализовать собственные платежи в решении Outlook.Check out our getting started guide to learn how to implement your own payments in Outlook solution.