Esta documentación detalla los pasos necesarios para integrar la funcionalidad de Link de Pagos a través de API. 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.
• Debes 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

A continuación encontrarás cómo crear un link de pago a través de API.

El siguiente es un ejemplo del body completo que es requerido para la creación:

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

{
  "order": {
    "order_id":            "ORD_000123",  
    "store_code":          "all",
    "currency":            "MXN",
    "total_tax_amount":    220,
    "items_total_amount":  7000,
    "sub_total":           7000,
    "total_amount":        7220,
    "items": [
      {
        "id":           "789012345",
        "name":         "Event Ticket",
        "description":  "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aenean euismod bibendum laoreet.",
        "quantity":     1,
        "unit_price": {
          "amount":          7220,
          "currency":        "PEN",
          "currency_symbol": "S/"
        },
        "tax_amount": {
          "amount":          0,
          "currency":        "PEN",
          "currency_symbol": "S/"
        },
        "total_amount": {
          "amount":          7220,
          "discount_amount": 0,
          "currency":        "PEN",
          "currency_symbol": "S/",
          "original_amount": 0
        },
        "image_url":    "https://cdn.stg.deuna.io/explore-deuna/assets/ticketevent.png"
      }
    ],
    "include_payment_options": [
                {
                    "payment_method": "credit_card",
                    "processors": [
                        "KUSHKI"
                    ]
                }
      ],
    "redirect_urls": {
      "close":    "https://www.google.com?q=close",
      "success":  "https://www.google.com?q=success",
      "pending":  "https://www.google.com?q=pending",
      "error":    "https://www.google.com?q=failure",
      "fallback": "https://www.google.com?q=fallback"
    }
  },
  "checkout_modules": [
    { "name": "UserInfoPattern"    },
    { "name": "OrderDetailPattern" },
    { "name": "LoginPattern"       }
  ],
  "configuration": {
    "expires_at":             "2025-11-07T03:40:11.054707389Z",
    "payment_link_name":      "creacion template + impuestos",
    "max_completed_purchases": 20,
    "max_payment_retries":     2
  }
}

Descripción de campos

A. Sección order

B. Sección checkout_modules

Define cuales módulos deseas que se muestren al abrir el Link de pago en tu widget:

❗️

Si no envías checkout_modules, usaremos los módulos configurados por defecto en tu comercio.
Para ver más información de Personalizaciones de módulos de Link de pagos

C. Sección configuration

Estos campos corresponden a las configuraciones y personalización de Links de pago. Para ver más detalle de cada funcionalidad Ver Enlaces de Pago

2. Integrar el Link de Pagos

Una vez se haya configurado el enlace de pago, podrá ser integrado en una aplicación o ser compartido por cualquier medio de comunicación.

Si desea integrarlo en una aplicación, esto implica la creación de una interfaz 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.

Al generar el link de pago, en la respuesta se generará el link de pago en el campo payment_link de la respuesta. Para integrar el link de pago se debe integrar una función en javascript, en dónde se realice un href.location que redireccione al link generado:

function openDeunaPayment() {
    const paymentLink = "https://api.deuna.io/payment-links/{payment-link-id}";
    window.location.href = paymentLink; // Abre el enlace en la misma ventana
}

<!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>

Prioridad para mostrar los módulos

Preguntas Frecuentes

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