.. meta::
   :description: Интеграция Оплата с использованием формы с Payneteasy: размещённая платёжная страница, собирающая данные держателя карты с поддержкой 3DS и обрабатывающая транзакцию полностью.

.. _sale_C:

Оплата с использованием формы
######################################################


.. role:: ex

.. role:: code

Введение
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

| Оплата — тип транзакции, при которой Плательщик получает товар или услугу от Присоединяющейся Стороны в обмен на деньги или другие активы. Интеграция по форме позволяет Присоединяющейся стороне снять с себя ответственность за хранение, обработку и передачу карточных данных Плательщика или какой-либо другой конфиденциальной информации о платеже. Эти данные вводятся Плательщиком на платёжной форме Payneteasy в среде, сертифицированной по стандарту безопасности PCI DSS.
| Все формы настраиваемы. Примеры и макросы - см. настройки :ref:`Платёжной Формы<payment_page_customization_reference>`, :ref:`Предварительно Заполненных Данных<prefilled_cardholder_data_in_payment_page>`, :ref:`Формы Ожидания<wait_page_customization_reference>` и :ref:`Финишной Формы<finish_page_customization_reference>` в разделе :ref:`Настройка Форм<forms_customization_reference>`. 
|
| Значение терминов см. в :ref:`Глоссарии<glossary>`.

.. _sale_request_url:

Сценарий оплаты по форме
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. uml::
  :align: center

    @startuml
    skinparam roundcorner 20
    skinparam sequenceArrowThickness 2
    skinparam ParticipantPadding 30
    actor Плательщик as Customer
    participant "Веб-сайт\nПрисоединяющейся Стороны" as Merchant
    participant "Платёжный Шлюз" as g
    autonumber
    Customer -> Merchant: Инициализация
    activate Merchant
    == Запрос на проведение оплаты ==
    Merchant -> g: api/v2/sale-form
    activate g
    g --> Merchant: Redirect-url, orderId
    deactivate g
    Merchant -> Customer: Предоставление redirect-url \nбраузеру Плательщика
    deactivate Merchant
    activate Customer
    Customer -> g: GET redirect-url
    deactivate Customer
    activate g
    g --> Customer: Форма оплаты
    deactivate g
    activate Customer
    Customer -> g: Подтверждение формы
    deactivate Customer
    activate g
    g --> g: Обработка оплаты
    == Финальное перенаправление клиента ==
    g -> Customer: redirect_url веб-сайта Присоединяющейся Стороны
    activate Customer
    Customer -> Merchant: POST redirect_url\nstatus, orderid
    deactivate Customer
    activate Merchant
    group Получение финального статуса
    == Получение обратного вызова \nПрисоединяющейся Стороны ==
    Merchant <- g: Обратный вызов с финальным статусом
    g <-- Merchant: HTTP 200
    deactivate g
    == Запрос статуса ==
    Merchant -> g: api/v2/status
    activate g
    g --> Merchant: Ответ \nstatus, order-stage
    deactivate g
    end
    Merchant --> Customer: Показ результата
    deactivate Merchant
    @enduml

| (2) Для имплементации запроса на проведение оплаты с использованием формы см.:ref:`/api/v2/sale-form/</api/v2/sale-form/>`.
| (9) Для имплементации финального перенаправления Плательщика см. :ref:`Финальное Перенаправление<final_redirect>`.
| (11,12) Для обработки обратного вызова с окончательным статусом заказа см. :ref:`Обратный вызов Присоединяющейся Стороны<merchant_callbacks>`.
| (13) Для имплементации запроса статуса заказа см.:ref:`/api/v2/status/</api/v2/status/>`. Статус должен запрашиваться несколько раз с интервалами в 3-5 секунд до получения финального статуса в ответе.

.. ifconfig:: "doc.payneteasy.com" in site_link

   ----

   .. admonition:: See also
      :class: related-cross-link

      `How a hosted payment page fits in the Fintegrate Cashier System → <https://payneteasy.com/solutions/fintegrate-payment-cashier-system>`_

.. ifconfig:: "doc.payneteasy.ru" in site_link

   ----

   .. admonition:: См. также
      :class: related-cross-link

      `Платёжный шлюз Payneteasy — все способы оплаты → <https://payneteasy.ru/solutions/gateway>`_