Introductie/Referenties

References

Netwerkcodes, valuta-netwerk-toewijzingen en betalingsstatuswaarden die in de hele 2328.io API worden gebruikt.

Deze pagina geeft een overzicht van alle referentiewaarden die in API-verzoeken en -responses worden gebruikt.

Netwerkcodes

Deze codes worden gebruikt waar een network-veld aanwezig is:

Code	Netwerk
`TRX-TRC20`	Tron TRC-20
`BSC-BEP20`	BNB Smart Chain
`ETH-ERC20`	Ethereum (ERC-20)
`BASE`	Base
`AVAX-C`	Avalanche C-Chain
`POL-MATIC`	Polygon (Matic)
`TON`	TON
`BTC`	Bitcoin
`LTC`	Litecoin
`DASH`	Dash
`SOL`	Solana
`DOGE`	Dogecoin
`ZEC`	Zcash
`XRP`	XRP Ledger
`XMR`	Monero

Valuta-netwerk-toewijzing

Elke valuta is alleen beschikbaar op een subset van netwerken. Gebruik deze tabel om een geldige combinatie te kiezen:

Valuta	Toegestane netwerken
`USDT`	TRX-TRC20, BSC-BEP20, ETH-ERC20, BASE, AVAX-C, POL-MATIC, TON, SOL
`USDC`	BSC-BEP20, ETH-ERC20, BASE, AVAX-C, POL-MATIC, SOL
`BTC`	BTC
`ETH`	ETH-ERC20, BASE
`BNB`	BSC-BEP20
`TRX`	TRX-TRC20
`LTC`	LTC
`DASH`	DASH
`GRAM`	TON
`AVAX`	AVAX-C
`POL`	POL-MATIC
`SOL`	SOL
`DOGE`	DOGE
`ZEC`	ZEC
`XRP`	XRP
`XMR`	XMR

GRAM is de canonieke activacode voor de TON-native valuta. De APIs voor betaling, statische portemonnee en uitbetalingscreatie accepteren momenteel legacy TON-invoer en normaliseren dit naar GRAM; integraties moeten de canonieke waarde die door de API wordt geretourneerd opslaan en verwerken. Het native activum van Polygon is POL, terwijl de netwerkcode POL-MATIC is. Verstuur nooit MATIC als netwerkcode.

Ingeschakelde richtingen zijn operationele configuraties en kunnen onafhankelijk van deze catalogus veranderen. Raadpleeg /v1/directions voordat je keuzes presenteert; behandel deze tabel als de geldige codemap en niet als een garantie dat elk paar momenteel is ingeschakeld.

Betalingsstatussen

Het veld payment_status op betalingen en de filter /v1/payment/list neemt de volgende waarden aan:

Status	Beschrijving
`pending`	Aangemaakt, wacht op initialisatie
`check`	Wacht op betaling van klant
`paid`	Succesvol betaald
`underpaid_check`	Te weinig betaald (kan worden bijgevuld)
`underpaid`	Te weinig betaald
`overpaid`	Te veel betaald (bijgeboekt)
`cancel`	Geannuleerd / verlopen
`aml_lock`	Transactie geblokkeerd vanwege AML

Wanneer je luistert naar een succesvolle betaling, moet je zowel paid als overpaid als succesvolle statussen behandelen en de order van de klant bijboeken.

Beleidsregels voor statusafhandeling

Status	Bestelling uitvoeren?	Blijven wachten?	Operationele actie
`pending` / `check`	Nee	Ja, tot de vervaldatum	Toon de in afwachting zijnde status en verwerk normaal.
`underpaid_check`	Nee standaard	Ja, bijbetaling kan arriveren	Sla elk txid idempotent op en toon de resterende-betaling workflow.
`paid`	Ja, eenmaal	Nee	Voer atomaire uitvoering uit vanaf het geverifieerde evenement.
`overpaid`	Ja, eenmaal	Nee	Voldoe en behoud overtollige/werkelijke bedragen voor het beleid van de handelaar.
`underpaid`	Product-specifiek	Nee	Pas expliciet beleid voor gedeeltelijke betaling/handmatige beoordeling toe.
`cancel`	Nee	Nee	Markeer verlopen/geannuleerd, maar escaleer eventueel latere bewijsstukken op de blockchain.
`aml_lock`	Nee	Geen automatische uitvoering	Compliance/ondersteuningsbeoordeling; vrijwaarde niet automatisch.

Statussen beschrijven het perspectief van het platform op de betaling. Ze vervangen niet uw lokale uitvoeringsstatus. Bewaar beide zodat een terugbetaalde, handmatig beoordeelde of reeds uitgevoerde bestelling niet beschadigd kan worden door een oudere webhook.

Het /v1/payment/list aanvraagfilter accepteert momenteel pending, check, paid, underpaid_check, underpaid, overpaid en cancel. Het accepteert aml_lock niet als filter, ook al kan een AML-vergrendelde betaling worden teruggegeven door andere betaaldiensten.

Uitbetalingsstatussen

Het veld status op /v1/payout en /v1/payout/status/{uuid} neemt een van de volgende waarden aan:

Status	Beschrijving
`pending`	Aangemaakt, wacht op verwerking
`completed`	Succesvol voltooid — `txid` is ingesteld
`failed`	Verzendfout — zie `error_type`
`cancelled`	Geannuleerd

Foutsoorten van uitbetalingen

Wanneer een uitbetaling status = failed heeft, beschrijft het veld error_type de reden:

Code	Beschrijving
`aml_risk`	Uitbetaling geblokkeerd door AML-risicocontroles (ontvangeradres gemarkeerd als hoog risico)