Foutafhandeling

Geef onError mee en toon de melding. De meeste fouten kan de klant zelf oplossen, en stilte zorgt er alleen voor dat de klant het blind opnieuw probeert.

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

Veelvoorkomende fouten

Verkeerd netwerk. De wallet staat op een andere chain dan de betaling. De SDK vraagt om over te schakelen; sommige wallets weigeren programmatisch wisselen en dan moet de klant het zelf aanpassen.

Niet genoeg gas. De klant heeft de stablecoin, maar geen native munt om de overdracht te betalen. Dit wordt vóór verzending opgevangen door de saldocontrole.

Geweigerd in de wallet. De klant heeft de handtekening geweigerd. Geen fout om excuses voor aan te bieden. Laat de klant het opnieuw proberen.

Betaling verlopen. Betalingen blijven niet onbeperkt open. Maak een nieuwe aan.

Chain niet geconfigureerd. Een betaling aanmaken op een chain zonder afwikkelingswallet wordt geweigerd, met vermelding van de chain. Los dit op in uw merchantinstellingen, niet in code.

Wat u niet moet doen

Probeer het aanmaken van een betaling niet opnieuw zonder idempotentiesleutel. Stuur een Idempotency-Key-header, of ten minste dezelfde orderId, zodat de server een nieuwe poging kan onderscheiden van een tweede aankoop. Zie Veilig opnieuw proberen.

Beschouw een 500 bij het opvragen van een betaling niet als een storing voordat u de ID hebt gecontroleerd. Een onbekende betalings-ID retourneert momenteel 500 in plaats van 404. Zie Fouten.