PayPal a través de un widget
En esta página
Esta página incluye los pasos necesarios para integrar PayPal usando el Widget DEUNA.
Pasos de integración#
Ahora que se establecen los requisitos técnicos, puede iniciar la integración.
1. Configurar el procesador de pagos
- Agregue la billetera PayPal a su Conexiones de administrador de DEUNA.
- Busque "PayPal Wallet" y luego ingrese las credenciales de su cuenta comercial de PayPal.
Conexiones
Descubre y administra integraciones de pago, billeteras y antifraude.
| Conexiones | Tipo | Estado | Acción |
|---|---|---|---|
| Adyen | Pasarela de pago | Conectada | |
| Worldpay | Pasarela de pago | Conectada | |
| PayPal | Método de pago | Conectada | |
| Mercado Pago | Método de pago | Sin conectar | |
| Riskified | Motor antifraude | Sin conectar |
2. Crear orden
Para realizar una compra, primero debes crear un pedido DEUNA.
Siga los pasos para Crear un pedido.
La API devolverá un order_token que se utiliza durante todo el flujo.
Campos obligatorios:
| Campo | Descripción | Valor |
|---|---|---|
order.store_code | Código único de tienda | all |
order.payment_method | Tipo de método de pago DEUNA. (Para integración API) | wallet |
order.items_total_amount | Importe total de artículos sin impuestos ni descuentos. | 2000 |
Consideraciones:
- Acerca de
order.items:total_amount.original_amountdebe serunit_price.amount * quantity.total_amount.amountdebe ser((unit_price.amount + tax_amount.amount) * quantity) - total_amount.total_discount.total_amount.total_discountes el valor total de los descuentos por la cantidad de artículos.
order.items_total_amountes la suma de los precios unitarios de los artículos, esta cantidad se suma alorder.total_tax_amounty menosorder.discount_amountdebe coincidir con elorder.total_amount.order.sub_totales la suma del precio unitario de los artículos menos los descuentos, esta cantidad se suma alorder.total_tax_amountdebe coincidir con elorder.total_amount.
3. Crear usuario (opcional)
Crea un usuario con DEUNA para poder obtener el token de autorización para realizar la compra posteriormente. Esta API devolverá la información de un usuario token los cuales serán requeridos para seguir los siguientes pasos.
Para crear un usuario, siga las Referencia de API. En caso de que el correo electrónico utilizado ya exista, la API devolverá el mensaje user already exists, para que puedas proceder a Solicitar la OTP y luego, Iniciar sesión con la OTP para obtener un nuevo usuario token y proceder con la compra.
Pagos de widgets#
El widget DEUNA permite dos procesos de pago para el widget de PayPal en DEUNA, que están documentados en esta guía. Cada proceso se inicia dependiendo de los atributos del usuario que realiza la compra.
- proceso expreso: Completa el pago en el menor tiempo posible.
- Proceso general: Permite diferentes métodos de pago.
expreso#
El flujo expreso se inicializa cuando el widget detecta una experiencia de método de pago único. Este flujo permite al usuario completar su pago en el menor tiempo posible.
Una vez que el usuario da su consentimiento para guardar su cuenta PayPal, el pago se realiza de forma automática y con un solo clic.
Usuario nuevo o invitado con bóveda deshabilitada
El flujo de invitados se define para usuarios nuevos, usuarios registrados que no están autenticados o cuando el comerciante ha desactivado la función Vaulting. En este caso se inicializa el proceso de pago checkout, donde el usuario ingresará a su cuenta PayPal para realizar el pago pero este no quedará guardado.
Si el usuario es nuevo, entonces se registran sus datos para que pueda autenticarse para una futura compra y guardar su cuenta PayPal para futuros pagos.
Usuario autenticado sin cuenta PayPal guardada
Si el usuario ha iniciado sesión pero no tiene una cuenta de PayPal guardada, entonces se inicia el proceso de pago de almacenamiento y se redirige al usuario al sitio de PayPal donde realizará el pago y dará su consentimiento para guardar su cuenta y usarla para compras futuras.
Usuario autenticado con cuenta PayPal guardada
Si el usuario se ha autenticado y ya tiene guardada una cuenta PayPal, entonces el pago se procesa inmediatamente porque previamente ha dado su consentimiento.
generales#
El flujo general se habilita cuando el widget detecta una experiencia con múltiples métodos de pago.
El usuario tendrá un rol mayor porque podrá administrar sus cuentas, es decir, podrá agregar varias cuentas o eliminar una que ya no utilice.
Los usuarios autenticados también tienen la posibilidad de seleccionar cuotas de pago dependiendo de si el comercio las requiere o las permite.
Usuario nuevo o invitado con bóveda deshabilitada
Cuando el usuario es un usuario nuevo o no autenticado o el comerciante ha desactivado la función de almacenamiento:
- El usuario hace clic en el botón PayPal.
- Se inicia el proceso de pago del checkout
- El usuario deberá autenticarse en PayPal y realizar el pago.
En este proceso no se guarda la cuenta porque no existe una identificación previa del usuario, y sus datos ya quedarán registrados (si son nuevos) para que en una futura compra tenga la posibilidad de autenticarse y dar su consentimiento para guardar su cuenta PayPal.
Ejemplo de compra
A continuación se muestra un ejemplo de un usuario realizando una compra con PayPal en DEUNA:
Usuario autenticado sin cuentas de PayPal guardadas
Cuando el usuario se ha autenticado y no tiene cuentas guardadas:
- Se inicia el proceso de pago de bóveda y el usuario es redirigido a PayPal.
- El usuario realiza el pago en el sitio de PayPal.
- El usuario da su consentimiento para guardar su cuenta y/o utilizarla para futuras transacciones.
Si el comerciante requiere pago a plazos, entonces el usuario deberá seleccionarlos luego de autorizar el pago en PayPal.
Usuario autenticado con cuentas de PayPal guardadas
Si el usuario ha iniciado sesión y ha guardado cuentas de PayPal, puede seleccionar cualquier cuenta para realizar el pago. El usuario también puede eliminar cualquier cuenta o guardar una nueva.
Si el comerciante ofrece pago en cuotas, estas se muestran con la cuenta seleccionada para el pago y si el usuario desea utilizar una nueva cuenta PayPal, deberá seleccionar las cuotas después de autorizar el pago en PayPal.
Vista de cuenta única
Este es un ejemplo de un usuario con una única cuenta PayPal en DEUNA:
Vista de varias cuentas
Este es un ejemplo de un usuario con múltiples cuentas PayPal en DEUNA:
Ejemplo de compra
Este es un ejemplo de un usuario realizando una compra con PayPal en DEUNA:
Transacción fallida de PayPal con Vaulting
Cuando se rechaza un pedido de PayPal durante el flujo de Vaulting, eliminamos automáticamente el token de PayPal asociado con la cuenta utilizada en el intento fallido.
Esto evita futuras transacciones con la cuenta no válida. Inmediatamente después, el widget reinicia el proceso de PayPal para que el usuario pueda volver a autenticarse y vincular una nueva cuenta de PayPal válida para completar el pago.
Montos de descuento
Los descuentos en PayPal se admiten a nivel de pedido. En la carga útil, debes procesar cualquier descuento a través de discount_amount.