Integración

Modo embed

Agrega checkout MakePay con botones declarativos o la API del navegador.

Botón embebido

Atributos requeridos

La integración declarativa es ideal para páginas de producto, facturas y páginas estáticas de CMS donde puedes agregar una etiqueta de script y el marcado de un botón.

  • Usa data-makepay-payment-link con el UID de pago que quieres abrir.
  • Carga el script modal antes de que el cliente pueda pulsar el botón de pago.
  • Mantén el elemento accesible por teclado con un elemento real button o a.
html
<script src="https://cdn.makepay.io/modal/makepay.min.js"></script>
<button type="button" data-makepay-payment-link="YOUR_PAYMENT_UID">
  Pay with crypto
</button>

API del navegador

Usa la API global del navegador cuando tu aplicación controla el manejador de clic o necesita pasar callbacks de ciclo de vida directamente.

  • Abre un modal de pago con window.makepay.showPayment(uid, { onEvent }).
  • Cierra el modal actual con window.makepay.hide().
html
<script src="https://cdn.makepay.io/modal/makepay.min.js"></script>
<button type="button" id="pay-with-makepay">Pay with crypto</button>
<script>
  document.getElementById("pay-with-makepay").addEventListener("click", function () {
    window.makepay.showPayment("YOUR_PAYMENT_UID", {
      onEvent: function (event) {
        if (event.type === "makepay.payment.redirect_requested" && event.payload.redirectUrl) {
          window.location.assign(event.payload.redirectUrl);
        }
      },
    });
  });
</script>

Manejo de callbacks

Pasa un callback onEvent cuando tu página necesite reaccionar a cambios de estado del checkout o solicitudes de redirección sin escuchar globalmente en window.

Cuándo usarlo

Usa el botón embebido cuando el sitio del merchant no necesita ejecutar JavaScript personalizado antes de abrir el checkout. Usa la API del navegador cuando tu aplicación controla el clic o necesita callbacks para una apertura concreta.

¿Necesitas ayuda con la configuración de partner?

Abre la vista de detalles del enlace de pago en MakeCrypto para copiar los snippets generados para un UID de pago real, o vuelve al portal para gestionar la configuración del merchant.

Abrir portal