Introductie/Algemene informatie
Algemene informatie
Technische specificatie voor de integratie van crypto-betalingsverwerking en uitbetalingen met 2328.io.
Welkom bij de 2328.io API-documentatie. Deze referentie beschrijft hoe je crypto-betalingsverwerking en uitbetalingen in je applicatie integreert.
Aan de slag
Om te beginnen met de integratie:
- Maak een merchantaccount en project aan op 2328.io
- Haal je project UUID en API key op uit de projectinstellingen
- Genereer een aparte Payout API key als je uitbetalingen wilt gebruiken
- Lees de sectie Authenticatie om te leren hoe je verzoeken ondertekent
- Doe je eerste Betaling aanmaken-aanroep
Base URL
Alle API-verzoeken in productie gebruiken de volgende base URL:
Text
https://api.2328.io/apiAlle verzoeken moeten via HTTPS worden gedaan. Verzoeken zonder HTTPS worden geblokkeerd.
Wat je kunt doen
Met de 2328.io API kun je:
- Crypto-betalingen accepteren — betalingssessies aanmaken en klanten doorverwijzen naar een gehoste checkout of Telegram MiniApp
- Geld uitbetalen — uitbetalingen vanaf je merchantsaldo programmatisch versturen naar elk blockchain-adres
- Saldi controleren — bekijk merchant-saldi per valuta, USD-equivalenten en door AML vergrendelde bedragen
- Statische wallets gebruiken — permanente stortingsadressen aanmaken die gekoppeld zijn aan een gebruiker of order
- Wisselkoersen ophalen — realtime wisselkoersen voor fiat- en cryptoparen ophalen
- Webhooks ontvangen — direct een melding krijgen wanneer de status van een betaling verandert
Rate limits
De API staat tot 10 verzoeken per seconde per project toe. Verzoeken boven de limiet krijgen een HTTP 429 Too Many Requests-response — wacht even en probeer opnieuw.