Einbettungsmodus

Schaltflächeneinbettung

Erforderliche Attribute

Die deklarative Integration eignet sich am besten für Produktseiten, Rechnungen und statische CMS-Seiten, auf denen Sie ein Skript-Tag und Schaltflächen-Markup hinzufügen können.

• Verwenden Sie data-makepay-payment-link mit der Zahlungs-UID, die Sie öffnen möchten.
• Laden Sie das modale Skript, bevor der Kunde auf die Zahlungsschaltfläche klicken kann.
• Halten Sie die Elementtastatur mit einem echten button- oder a-Element erreichbar.

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

Browser-API

Verwenden Sie die globale Browser-API, wenn Ihre Anwendung den Click-Handler besitzt oder Lebenszyklusrückrufe direkt übergeben muss.

• Öffnen Sie ein Zahlungsmodal mit window.makepay.showPayment(uid, { onEvent }).
• Schließen Sie das aktuelle Modal mit 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>

Rückrufabwicklung

Übergeben Sie einen onEvent-Rückruf, wenn Ihre Seite auf Änderungen des Checkout-Status oder Umleitungsanfragen reagieren muss, ohne global auf window zu lauschen.

Wann sollte man es verwenden?

Verwenden Sie die Schaltflächeneinbettung, wenn die Händlerseite vor dem Öffnen des Bezahlvorgangs kein benutzerdefiniertes JavaScript ausführen muss. Verwenden Sie die Browser-API, wenn Ihre Anwendung den Klick steuert oder Rückrufe für einen einzelnen Modalaufruf benötigt.