# 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:

1. Maak een merchantaccount en project aan op [2328.io](https://2328.io)
2. Haal je **project UUID** en **API key** op uit de projectinstellingen
3. Genereer een aparte **Payout API key** als je uitbetalingen wilt gebruiken
4. Lees de sectie [Authenticatie](/docs/authentication) om te leren hoe je verzoeken ondertekent
5. Doe je eerste [Betaling aanmaken](/docs/payments)-aanroep

## Base URL

Alle API-verzoeken in productie gebruiken de volgende base URL:

```
https://api.2328.io/api
```

> **WARNING:** Alle 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.