Esta documentación detalla los pasos necesarios para integrar la funcionalidad de Link de Pagos en una aplicación de pago. Nuestro Link de Pagos permite a los comercios crear enlaces de pago para sus clientes, lo que facilita y agiliza el proceso de pago a través de la plataforma de DEUNA y reduce drásticamente la necesidad de hacer algún desarrollo. Nuestros Links de Pagos son 100% carta blanca, es decir, pueden personalizarse con el look and feel de tu marca.

Antes de Comenzar

Este documento supone que ya tienes un conocimiento básico de JavaScript y Typescript.
Disponer de las credenciales de DEUNA. Para poder obtener tus credenciales como el Private API Key debes estar registrado y haber solicitado las credenciales de acceso de tu comercio en nuestro panel de administrador.

Configuración

1. Creación de un Link de Pagos

La metodología para generar un enlace de pago consiste en la tokenización de una orden de tipo PAYMENT_LINK.

Consulta la documentación para generar un link de pago aquí.

Importante al momento de crear un link de pago debes enviar el campo order_type con el valor PAYMENT_LINK.

Después de crear la orden de tipo PAYMENT_LINK obtendrás un response similar al siguiente en donde encontraras el link de pago.


{
  "token": "c5c5abc9-67a7-4a44-aa83-ee7e81d7052c",
  "order": {
    ...
    "payment_link": "https://pay.stg.deuna.com/{{order_token}}",
    ...
    "items": [...],
    "shipping_address": {...},
    "billing_address": {...}
  }
}

Configuración del Body para Link de Pagos

Aquí un ejemplo de cómo debería ser el body para una orden de Link de Pagos.

Atributo	Tipo	Ejemplo	Descripción
(requerido) `order_type`	string	PAYMENT_LINK	Tipo de la orden. Es esencial definir esta orden como PAYMENT_LINK.
(requerido) `order`→`checkout_modules`→`name`	string	LoginPattern	Nombre del módulo, puede ser alguno de la lista de módulos disponibles.
(opcional) `order`→`include_payment_options`	array		La esta propiedad define los métodos de pago disponibles para la orden. Y caso de estar vacío llegan los métodos de pago asociados a la tienda.
(requerido) `order`→`include_payment_options`→`payment_method`	string	credit_card	Nombre del método de pago a tokenizar. Si el valor de esta propiedad es credit_card o debit_card entonces se omitirá la propiedad processors. El merchant deberá de tener configurado por lo menos un procesador para este método de pago, de lo contrario la tokenización de la orden fallará.
(opcional) `order`→`include_payment_options`→`processors`	array	[”amex”]
(opcional) `order`→ `redirect_urls`→`success`	string	http://domain.success.com	Enlace de redirección cuando la orden es procesada exitosamente
(opcional) `order`→ `redirect_urls`→`pending`	string	http://domain.pending.com	Enlace de redirección cuando la orden es procesada y queda en un estado pending
(opcional) `order`→`redirect_urls`→`error`	string	http://domain.error.com	Enlace de redirección cuando la orden es procesada erróneamente
(opcional) `order`→`redirect_urls`→`fallback`	string	http://domain.fallback.com	Enlace de redirección del botón de Regresar en vistas de error. Si no está presente, se redirige al la vista que levantó el Payment Link.

2. Integrar el Link de Pagos

Una vez que haya configurado la funcionalidad de Link de pagos, deberá integrarla en su aplicación de pago. Esto implica la creación de una interfaz de usuario para que los usuarios puedan hacer uso de sus enlaces de pago, así como la implementación de la lógica de procesamiento de pagos en su aplicación.

<!DOCTYPE html>
<html>
  .
  .
<body>
 <div class="container">
        <h1>Realizar Pago</h1>
        <p>Haz clic en el botón "Pagar con Deuna" para continuar con el pago.</p>
        <button id="payButton" class="pay-button" onclick="openDeunaPayment()">Pagar con Deuna</button>
    </div>
    <script src="app.ts"></script>
</body>
</html>

function openDeunaPayment() {
    const paymentLink = "https://pay.stg.deuna.com/{{order_token}}";
    window.location.href = paymentLink; // Abre el enlace en la misma ventana
}

Prioridad para mostrar los módulos

Prioridad	Fuente de Configuración	Descripción
1	Módulos pasados al ejecutar la función `.initPaymentWidget`en el campo `checkout_modules`	Los módulos se muestran según los que se pasan al iniciar el widget.
2	Módulos pasados en la orden en`checkout_modules`	Se revisa la orden para verificar si `checkout_modules` tiene módulos a mostrar.
3	Configuración global del comercio	Si no se pasa en los `checkout_modules` en la función `.initPaymentWidget` ni en `checkout_modules` al momento de crear la order, se toman los `checkout_modules` configurados a nivel comercio.

Preguntas Frecuentes

Obtén respuestas a preguntas comunes acerca de nuestro Payment Link

¿Qué es el Link de Pagos DEUNA y cuál es su propósito?

El Link de Pagos DEUNA es una funcionalidad que permite a los comercios crear enlaces de pago para sus clientes. Su propósito es simplificar y agilizar el proceso de pago, además de ofrecer opciones de personalización.

¿Qué significa que el link de pago sea de "Único uso"?

Un link de pago de "UNICO USO" significa que solo se puede utilizar una vez. Una vez que la transacción se completa, el link ya no está disponible para su uso.

¿Puedo personalizar la apariencia del Link de Pagos DEUNA en mi aplicación?

Sí, el Link de Pagos DEUNA permite personalizaciones, como incluir el logo del comercio y cambiar los colores de la barra de estilo y los botones.

¿Puedo personalizar la página de agradecimiento (thank you page) después de que se genere el pago a través del Link de Pagos DEUNA?

Sí, una vez que se complete el pago, se mostrará una thank you page que indicará si la transacción fue exitosa o si ocurrió un error. Te permitimos definir una URL de success en la tokenización de la orden, con la redirección a tu propia página de agradecimiento personalizada para procesar información adicional o realizar acciones específicas.

¿Se envía OTP (Código de Verificación) para todos los métodos de pago?

El envío de OTP se realiza de acuerdo a ciertos criterios, y no siempre es necesario. Para obtener detalles sobre cuándo se requiere OTP, consulta la documentación proporcionada.

¿Pueden mis clientes continuar como invitado a pesar de que estén registrados en la red de DEUNA?

Sí, podrán continuar como invitado desde la pantalla de OTP, pero no podrán acceder a la información de tarjetas guardadas en tu cuenta.

¿Qué sucede si intento acceder a un link de pago que ha caducado?

Si intentas acceder a un link de pago que ha caducado, se mostrará una pantalla de error con instrucciones claras sobre cómo proceder.

¿Se puede procesar órdenes con diferentes métodos de pago, como tarjetas de crédito/débito, SPEI o OXXO?

Sí, el Link de Pagos DEUNA admite diferentes métodos de pago, incluyendo tarjetas de crédito/débito, SPEI (transferencias) y OXXO (referencia de pago), según estén disponibles en la orden.

¿Pueden mis clientes realizar cambios en el monto a pagar dentro del Link de Pagos DEUNA?

No es posible modificar el monto a pagar dentro del Link de Pagos DEUNA. Cualquier cambio en el monto debe realizarse en la sección correspondiente del comercio electrónico, generando una nueva orden tokenizada y un nuevo link de pago.

¿Dónde puedo obtener más ayuda o realizar preguntas adicionales sobre el Link de Pagos DEUNA?

Cualquier pregunta adicional o necesidad de asistencia adicional puede ser atendida comunicándote con el equipo de soporte de DEUNA. Puedes enviar un correo electrónico a [email protected] para obtener la asistencia necesaria.