PayPal via Widget
This page includes the steps necessary to integrate PayPal using the DEUNA Widget.
Widget payments
The DEUNA widget allows for two payment process for the PayPal Widget in DEUNA, which are documented in this guide. Each process is started depending on the attributes of the user who makes the purchase.
- Express process: Completes the payment in the shortest possible time.
- General process: Allows different payment methods.
Express
The express flow allows the user to complete their payment in the shortest possible time.
Once the user gives consent to save their PayPal account, the payment is made automatically and with a single click. The express flow is initialized when the widget detects a single payment method experience, i.e. PayPal only.

New/Guest user with vaulting disabled
The guest flow is defined for new users, registered users who are not authenticated or when the merchant has disabled the Vaulting feature. In this case, the Checkout payment process is initialized, where the user will enter their PayPal account to make the payment but it will not be saved.
If the user is new, then their data is registered so that they can authenticate themselves for a future purchase and save their PayPal account for future payments.

Authenticated user without PayPal account saved
If the user is logged in but does not have a PayPal account saved, then the Vaulting payment process is initiated and the user is redirected to the PayPal site where they will make the payment and give their consent to save their account and use it for future purchases.
Authenticated user with PayPal account saved
If the user has authenticated and already has a PayPal account saved, then the payment is processed immediately because they have previously given their consent.

General
The general flow is enabled when the widget detects an experience with multiple payment methods.
The user will have a greater role because they are able to manage their accounts, that is, they are able to add multiple accounts or delete one that they no longer use.
Authenticated users also have the possibility to select payment installments depending on whether the merchant requires or allows them.
New/Guest user with vaulting disabled
When the user is an unauthenticated/new user or the merchant has disabled the Vaulting feature:
- The user clicks the PayPal button
- The Checkout payment process initiates
- The user must authenticate themselves in PayPal and make the payment.
In this process, the account is not saved because there is no previous identification of the user, and their data will already be registered (if they are new) so that in a future purchase they will have the possibility of authenticating themselves and giving consent to save their PayPal account.

Purchase example
This is an example of a user making a purchase with Paypal in DEUNA:

Authenticated user without PayPal accounts saved
When the user has authenticated and has no saved accounts:
- The Vaulting payment process is initiated and the user is redirected to PayPal.
- The user makes the payment on Paypal's site.
- The user give their consent to save their account and/or use it for future transactions.
If the merchant requires payment installments, then the user will have to select them after authorizing the payment in PayPal.
Authenticated user with PayPal accounts saved
If the user is logged in and has saved PayPal accounts, then they can select any account to make the payment. The user can also delete any accounts or save a new one.
If the merchant offers payment installments, then these are displayed with the account selected for payment and if the user wants to use a new PayPal account, they will have to select the installments after authorizing the payment in PayPal.
Single account view
This is an example of a user with a single PayPal account in DEUNA:

Multiple accounts view
This is an example of a user with multiple PayPal accounts in DEUNA:

Purchase example
This is an example of a user making a purchase with Paypal in DEUNA:

Updated about 4 hours ago