Documentación de Links de pago en Tpaga
============================================

Los links de pago permiten a un comercio incluir su tienda virtual en
la aplicación :term:`Billetera Tpaga`.

El proceso de compra usando los links de pago se realiza en el siguiente orden:

..
    https://www.planttext.com/
    actor Comprador as user
    participant "Comercio" as company
    participant "Tpaga API" as tpaga_api
    participant "Billetera Tpaga" as wallet
    company -> tpaga_api: Crea una solicitud de pago
    tpaga_api -> company: Devuelve link de pago.
    company -> user: Pasa el  link de pago al comprador.
    user -> wallet: Abre el link de pago en su dispositivo móvil.
    wallet -> user: Muestra el widget de pago.
    user -> wallet: Selecciona el método de pago y oprime "Pagar".
    wallet -> tpaga_api: Solicita el cobro.
    tpaga_api -> wallet: Realiza el cobro y devuelve al link de finalización de compra.
    wallet -> user: Redirige al link de finalización de compra.
    user -> company: Abre el link de finalización de compra.
    company -> tpaga_api: Pregunta por el estado de pago.
    tpaga_api -> company: Confirma el estado de pago.
    company -> tpaga_api: Reporta que el  producto fue entregado.

Diagrama de flujo de pago por medio de un link de pago Tpaga:

.. image:: _static/payment_sequence_diagram.png
    :alt: Flujo de pago
    :align: center

..
    https://www.planttext.com/
    actor Comprador as user
    participant "Comercio" as company
    participant "Tpaga API" as tpaga_api
    participant "Billetera Tpaga" as wallet
    company -> tpaga_api: Crea una solicitud de pago
    tpaga_api -> company: Devuelve link de pago.
    company -> user: Pasa el  link de pago al comprador.
    user -> wallet: Abre el link de pago en su dispositivo móvil.
    wallet -> user: Muestra el widget de pago.
    user -> wallet: Selecciona el método de pago y oprime "Pagar".
    wallet -> tpaga_api: Solicita el cobro.
    tpaga_api -> wallet: Realiza el cobro y devuelve al link de finalización de compra.
    wallet -> company: Notifica finalización de la compra.
    company -> tpaga_api: Pregunta por el estado de pago.
    tpaga_api -> company: Confirma el estado de pago.
    company -> tpaga_api: Reporta que el  producto fue entregado.

Tpaga ofrece otra forma de notificar al comercio cuando el usuario finaliza
la compra, la diferencia en el flujo de pago está en que la billetera Tpaga
no va redirigir al usuario a una página del comercio una vez este ha
finalizado la compra, el usuario queda en la aplicación, y  el backend de Tpaga
le va a notificar directamente al backend del comercio, por medio de un
webhook que el estado del link de pago cambio.

.. image:: _static/webhook_payment_sequence_diagram.png
    :alt: Flujo de pago
    :align: center


.. toctree::
   :maxdepth: 2
   :caption: Contenido:

   quickstart
   glossary
   swagger

Índice
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`