Configuratie

Componentprops

Prop	Verplicht	Opmerkingen
publicKey	ja	uw pk_-key
apiUrl	ja	https://hub.stablezact.com
isOpen / onClose	ja	u bepaalt de zichtbaarheid
config	ja	de betaling zelf, zie hieronder
onSuccess	ja	wordt geactiveerd bij verzending, niet bij bevestiging
onError	aanbevolen	wordt bij een fout aangeroepen met een melding
theme	nee	light of dark

Het config-object

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 geeft de stablecoin aan waarin de klant betaalt, geen fiatvaluta, en amount is uitgedrukt in die token.

Gebruik USDC of USDT. Dat zijn de enige twee die op enig netwerk zijn geconfigureerd. DAI en BUSD komen door de eerste validatie, maar mislukken daarna, omdat geen enkel netwerk ze ondersteunt:

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

Fiatcodes worden geweigerd:

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

Als u uw prijzen in fiat vaststelt, reken dan om voordat u de betaling aanmaakt. GET /currency/rates retourneert de koersen die elders in het systeem worden gebruikt.

orderId

Uw eigen referentie voor de aankoop. Plaats deze op het hoogste niveau, niet in metadata: een orderId op het hoogste niveau wordt ook gebruikt om een nieuwe poging te herkennen, zodat een herhaald request één betaling aanmaakt in plaats van twee. Een orderId die in metadata is weggestopt, wordt wel opgeslagen, maar doet daarvoor niets. Zie Veilig opnieuw proberen.

metadata

Willekeurige JSON, die bij elke opvraging van de betaling wordt teruggegeven en in webhooks wordt meegestuurd. Gebruik het voor alles wat u verder wilt meesturen. Het wordt genegeerd bij de beslissing of een request een nieuwe poging is, en daarom hoort de bestelreferentie in orderId thuis en niet hier.

callbackUrl

Waar webhooks voor deze betaling worden afgeleverd. Stel dit per betaling in, niet globaal; zie Webhooks.

Afwikkelingswallets

Op welke chains een klant kan betalen, wordt bepaald door de afwikkelingswallets die op uw merchantaccount zijn geconfigureerd, niet door iets in config. Een chain zonder wallet wordt niet aangeboden, en het rechtstreeks aanmaken van een betaling op zo’n chain wordt geweigerd:

{
  "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"
}