PayPal

Ampliar

Comience con PayPal#

Esta página proporciona una guía completa para integrar exitosamente Paypal con DEUNA.

PayPal es una plataforma de pago digital reconocida mundialmente que ofrece una forma segura y conveniente para que clientes y comerciantes realicen y reciban pagos electrónicos.

Cómo funciona#

Hay dos tipos de procesos de pago en PayPal que puedes elegir según tus necesidades:

Pago con PayPal

Experiencia de pago único que le brinda más control sobre todo el proceso de pago.

• Ofrece un flujo de pago optimizado que mantiene a los clientes cerca de su sitio web durante el proceso de autorización de pago.
• El proceso de pago no ofrece la posibilidad de almacenar la cuenta PayPal de un cliente.
• El pago solo ocurre para usuarios nuevos o no autenticados y, por lo tanto, como no tienen una identidad existente, aún no tienen la capacidad de seleccionar cuotas de pago.

Bóveda de PayPal

Este flujo le permite cargar la cuenta en el futuro sin requerir que el cliente esté presente durante la transacción o volver a autenticarse con PayPal cuando esté presente durante la transacción.

• PayPal Vault está disponible únicamente para usuarios autenticados.
• Vault tiene la capacidad de seleccionar cuotas de pago.

Requisitos#

El siguiente contenido enumera todos los requisitos para una integración exitosa con PayPal.

• Entornos:
  • Caja de arena: https://api.sandbox.deuna.io
  • Producción: https://api.deuna.io
• Colección cartero:
  https://www.postman.com/deunaonline/workspace/deuna/folder/30572503-42f68d9b-0763-4002-ba5f-7d1168462e59?action=share&source=copy-link&creator=36841419&ctx=documentation

Pasos de integración#

Ahora que se establecen los requisitos técnicos, puede iniciar la integración.

1. Configurar el procesador de pagos

1. Agregue la billetera PayPal a su Conexiones de administrador de DEUNA.
2. Busque "PayPal Wallet" y luego ingrese las credenciales de su cuenta comercial de PayPal.

2. Botón Pagar ahora

• Esta opción se controla directamente en el Administrador de DEUNA, en la configuración del método de pago de PayPal de su comerciante.

• Predeterminado: CONTINUAR: habilitado de forma predeterminada para todos los comerciantes (no es necesario realizar ninguna acción).

• Los comerciantes pueden habilitar "Pagar ahora" en cualquier momento directamente desde el administrador, sin necesidad de una nueva integración técnica.

• El cambio se puede revertir cuando sea necesario; esta no es una decisión única que se toma durante la integración, sino una alternancia que los controles del comerciante realizan de forma independiente.

  Cómo elegir la opción correcta

• La pregunta clave que debemos hacernos es: una vez que el comprador aprueba el pago en PayPal, ¿el monto final ya está bloqueado y no hay más pantallas de revisión en mi sitio antes del cargo?

• Si la respuesta es sí → utiliza PAGAR AHORA.

• Si la respuesta es no (el comprador aún puede cambiar los artículos, la dirección, el envío, los complementos o ve una pantalla de confirmación final) → use la opción predeterminada (no necesita realizar ninguna acción).

  Cuándo usar PAGAR AHORA

• Recomendado para flujos transaccionales, donde el precio ya está fijado en el momento en que el comprador es redirigido a PayPal:

  • Compra directa / "Comprar ahora" en la página de un producto, sin carrito ni paso de revisión adicional.

  • Boletos o reservas con un precio final fijo en el momento de la selección, es decir, sin selección de asiento, equipaje ni mejoras después de la devolución de PayPal.

  • Suscripciones y pagos recurrentes con importe fijo e inmutable.

  • Pago exprés/en un clic, donde cada paso adicional aumenta el abandono.

  • Bienes digitales (aplicaciones, juegos, contenido), donde el comprador espera "pago = entrega" al instante.

    Cuándo usar CONTINUAR (predeterminado)

  • Recomendado cuando todavía hay un paso de confirmación o revisión en el sitio del comerciante después de regresar de PayPal:

    • Carrito de artículos múltiples, donde el comprador puede agregar productos, aplicar un cupón o revisar el envío antes de confirmar.
    • Flujos en los que el envío o los impuestos solo se calculan después de la aprobación (por ejemplo, dependiendo de la dirección de entrega).
    • Reservas con opciones adicionales tras la aprobación, como selección de asiento o mejoras, antes de la captura final.

3. 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:

Consideraciones:

• Acerca de order.items:
  • total_amount.original_amount debe ser unit_price.amount * quantity.
  • total_amount.amount debe ser ((unit_price.amount + tax_amount.amount) * quantity) - total_amount.total_discount.
  • total_amount.total_discount es el valor total de los descuentos por la cantidad de artículos.
• order.items_total_amount es la suma de los precios unitarios de los artículos, esta cantidad se suma al order.total_tax_amount y menos order.discount_amount debe coincidir con el order.total_amount.
• order.sub_total es la suma del precio unitario de los artículos menos los descuentos, esta cantidad se suma al order.total_tax_amount debe coincidir con el order.total_amount.

4. Elige el tipo de integración

Después de crear un pedido, elige el tipo de integración que mejor se adapta a tus necesidades:

5. Integre FraudNet

Fraudnet es una biblioteca desarrollada por PayPal que analiza los datos enviados a través del navegador durante todo el proceso de compra para prevenir posibles fraudes en las transacciones realizadas.

Fraudnet debe estar ejecutándose durante todo el proceso de transacción. Para su integración, PayPal proporciona la siguiente documentación: Integrar FraudNet

6. Validar pagos

Valide los pagos y asegúrese de utilizar las reglas de PayPal correctamente.

Montos de descuento

Los descuentos en PayPal se admiten a nivel de pedido. En la carga útil, debe procesar cualquier descuento a través del discount_amount field.