Fehlerbehandlung

Übergeben Sie onError und zeigen Sie die Meldung an. Die meisten Fehler kann der Kunde selbst beheben, und ohne Meldung versucht er es nur blind erneut.

onError={(error) => {
  console.error('[stablezact]', error);
  showBanner(String(error));
}}

Häufige Fehler

Falsches Netzwerk. Die Wallet ist auf einer anderen Chain als die Zahlung. Das SDK fordert zum Wechseln auf; manche Wallets verweigern den programmatischen Wechsel, und der Kunde muss die Chain selbst ändern.

Nicht genug Gas. Der Kunde hält den Stablecoin, aber keine native Währung, um die Überweisung zu bezahlen. Wird vor dem Absenden durch die Guthabenprüfung abgefangen.

In der Wallet abgelehnt. Der Kunde hat die Signatur abgelehnt. Kein Fehler, für den Sie sich entschuldigen müssen. Lassen Sie ihn es erneut versuchen.

Zahlung abgelaufen. Zahlungen bleiben nicht unbegrenzt offen. Erstellen Sie eine neue.

Chain nicht konfiguriert. Das Erstellen einer Zahlung auf einer Chain ohne Auszahlungs-Wallet wird abgelehnt, unter Nennung der Chain. Beheben Sie das in Ihren Händlereinstellungen, nicht im Code.

Was Sie nicht tun sollten

Wiederholen Sie das Erstellen einer Zahlung nicht ohne Idempotenzschlüssel. Senden Sie einen Idempotency-Key-Header oder zumindest dieselbe orderId, damit der Server eine Wiederholung von einem zweiten Kauf unterscheiden kann. Siehe Sicher erneut versuchen.

Werten Sie ein 500 bei einem Zahlungsabruf nicht als Ausfall, bevor Sie die ID geprüft haben. Eine unbekannte Zahlungs-ID gibt derzeit 500 statt 404 zurück. Siehe Fehler.