Konfiguration

Komponenten-Props

Prop	Erforderlich	Hinweise
publicKey	ja	Ihr pk_-Key
apiUrl	ja	https://hub.stablezact.com
isOpen / onClose	ja	Sie steuern die Sichtbarkeit
config	ja	die Zahlung selbst, siehe unten
onSuccess	ja	wird bei der Übermittlung ausgelöst, nicht bei der Bestätigung
onError	empfohlen	wird bei einem Fehler mit einer Meldung aufgerufen
theme	nein	light oder dark

Das config-Objekt

config={{
    amount: 49.99,
    currency: 'USDC',     // USDC or USDT
    customerEmail: 'customer@example.com',
    callbackUrl: 'https://yourstore.com/webhooks/stablezact',
    orderId: 'ORD-1234',
    metadata: { basket: 'b-99', channel: 'web' },
}}

currency

currency bezeichnet den Stablecoin, in dem der Kunde zahlt, keine Fiatwährung, und amount wird in diesem Token angegeben.

Verwenden Sie USDC oder USDT. Nur diese beiden sind auf irgendeinem Netzwerk konfiguriert. DAI und BUSD bestehen die erste Validierung, schlagen dann aber fehl, weil kein Netzwerk sie führt:

{ "error": "Currency DAI is not supported on the base network" }

Fiat-Codes werden abgelehnt:

{
  "success": false,
  "error": "Validation failed",
  "message": "Unsupported currency: GBP"
}

Wenn Sie Preise in Fiat angeben, rechnen Sie um, bevor Sie die Zahlung erstellen. GET /currency/rates liefert die Kurse, die auch an anderen Stellen im System verwendet werden.

orderId

Ihre eigene Referenz für den Kauf. Setzen Sie sie auf oberster Ebene, nicht in metadata: Eine orderId auf oberster Ebene wird auch verwendet, um eine Wiederholung zu erkennen, sodass eine wiederholte Anfrage eine Zahlung erzeugt statt zwei. Eine orderId innerhalb von metadata wird gespeichert, bewirkt dafür aber nichts. Siehe Sicher erneut versuchen.

metadata

Beliebiges JSON, das bei jedem Abruf der Zahlung zurückgegeben und in Webhooks mitgesendet wird. Verwenden Sie es für alles andere, was Sie mitführen möchten. Bei der Entscheidung, ob eine Anfrage eine Wiederholung ist, wird es ignoriert. Deshalb gehört die Bestellreferenz in orderId und nicht hierher.

callbackUrl

Wohin Webhooks für diese Zahlung zugestellt werden. Legen Sie sie pro Zahlung fest statt global; siehe Webhooks.

Auszahlungs-Wallets

Auf welchen Chains ein Kunde zahlen kann, bestimmen die Auszahlungs-Wallets, die in Ihrem Händlerkonto konfiguriert sind, nicht irgendetwas in config. Eine Chain ohne Wallet wird nicht angeboten, und das direkte Erstellen einer Zahlung auf einer solchen Chain wird abgelehnt:

{
  "error": "You haven't set up a wallet address for the Polygon network",
  "message": "Please configure a Polygon-specific wallet in your merchant settings before accepting payments on this network.",
  "network": "polygon"
}