SDK aufseiten der Anwendung integrieren

Nach der Installation und Initialisierung des SDK:

  1. Initialisieren Sie das Zahlungsportal, indem Sie die Zahlungsmethoden-ID und die Weiterleitungs-URL angeben:
    • Die Methode headlessCheckout.form.init gibt ein Objekt zurück, das für die weitere Interaktion mit dem Zahlungsportal verwendet wird.
    • Die Weiterleitungs-URL dient dazu, den Nutzer weiterzuleiten, z. B. nach Abschluss der “3-D Secure”-Prüfung.
Hinweis

Auf derselben Seite können nicht mehrere Zahlungsmethoden initialisiert werden.

Bei der Initialisierung einiger Zahlungsmethoden erhalten Sie mitunter in der Antwort den Parameter isFormAutoSubmitted: true. Das bedeutet, dass der Schritt automatisch übersprungen wurde, da der Nutzer keine Daten in der Bezahlmaske eingeben musste (z. B. bei der Zahlung per QR-Code).

Beispiel:
Copy
Full screen
Small screen
1await headlessCheckout.form.init({
2  paymentMethodId: ID,
3  returnUrl: 'returnUrl',
4});
  1. Fügen Sie dem HTML-Markup des Zahlungsportals die folgenden Komponenten hinzu:
    • Zwingend erforderliche Komponenten:
      • psdk-legal – zur Anzeige von Informationen über Rechtsdokumente.
      • psdk-total – zur Anzeige des insgesamt zu zahlenden Kaufbetrags.
    • Zahlunsgmasken-Komponenten. Sie können entweder die integrierte Komponente psdk-payment-form verwenden oder die Zahlungsportal-Elemente manuell mithilfe gebrauchsfertiger Komponenten erstellen.
    • Die Kaufen-Schaltfläche-Komponente: psdk-submit-button.
Beispiel:
Copy
Full screen
Small screen
1<psdk-legal></psdk-legal>
2<psdk-total></psdk-total>
3
4
5<psdk-payment-form></psdk-payment-form>
6<psdk-submit-button text="Pay"></psdk-submit-button>
  1. Fügen Sie die Verarbeitung des Ereignisses check_status für die Zahlungsstatusänderung hinzu.
Beispiel:
Copy
Full screen
Small screen
1headlessCheckout.form.onNextAction((nextAction) => {
2  switch (nextAction.type) {
3    case 'check_status': {
4      showStatus = true;
5    }
6  }
7});
  1. Fügen Sie die Komponente psdk-status dem HTML-Markup des Zahlungsportals hinzu, um einen Zahlungsstatus anzuzeigen.
Beispiel:
Copy
Full screen
Small screen
1@if (showStatus) {
2  <psdk-status></psdk-status>
3}
War dieser Artikel hilfreich?
Vielen Dank!
Gibt es etwas, das wir verbessern können? Nachricht
Das tut uns leid
Bitte erläutern Sie, weshalb dieser Artikel nicht hilfreich ist. Nachricht
Vielen Dank für Ihr Feedback!
Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.
Letztmalig aktualisiert: 30. April 2026

Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.

Problem melden
Wir überprüfen unsere Inhalte ständig. Ihr Feedback hilft uns, sie zu verbessern.
Geben Sie eine E-Mail-Adresse an, damit wir Sie erreichen können
Vielen Dank für Ihr Feedback!
Ihr Feedback konnte nicht gesendet werden
Versuchen Sie es später erneut oder kontaktieren Sie uns unter doc_feedback@xsolla.com.