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-linkcon 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
buttonoa.
<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().
<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.