Betalingen en uitbetalingen/Payment API

Payment API

Maak en beheer crypto-betalingssessies met de Payment API van 2328.io.

Met de Payment API kun je betalingssessies aanmaken, klanten doorverwijzen naar een gehoste checkout en de status van betalingen volgen.

Betaling aanmaken

Maakt een betalingssessie aan en geeft een URL terug waarmee de klant kan betalen.

Verzoekparameters

Veld	Type	Vereist	Beschrijving
`amount`	decimal	ja	Betalingsbedrag in de valuta, bijv. `100.00`
`currency`	string	ja	Fiatvaluta (USD, EUR, RUB, …) of cryptovaluta (USDT, TRX, BTC, …)
`order_id`	string	ja	Je order-ID, bijv. `ORDER-12345` (max. 128 tekens)
`to_currency`	string	nee	Vooraf geselecteerde cryptovaluta
`network`	string	nee*	Netwerkcode (verplicht als `to_currency` is ingesteld of als `currency` een cryptovaluta is)
`url_return`	string	nee	Redirect-URL na betaling, bijv. `https://your-site.com/return`
`url_success`	string	nee	Alternatief voor `url_return`
`url_callback`	string	nee	URL voor webhook-meldingen, bijv. `https://your-site.com/webhook`
`invite_code`	string	nee	Verwijzerscode
`fee_split`	decimal	nee	Aandeel van de merchantfee dat aan de betaler wordt doorberekend, 0–100 (%). 0 = merchant betaalt volledig, 100 = betaler betaalt volledig. Overschrijft de project-instelling. Voorbeeld: `30` (betaler dekt 30% van de fee).
`price_markup`	decimal	nee	Toeslag of korting op het factuurbedrag, −99 tot 100 (%). Overschrijft de project-instelling. Voorbeeld: `5` (+5%) of `-10` (10% korting).
`description`	string	nee	Optionele factuurbeschrijving (max. 200 tekens). Wordt op de betaalpagina aan de betaler getoond. Voorbeeld: `Premium plan — Order #12345`.
`ttl_seconds`	int	nee	Levensduur van de factuur in seconden, van `300` (5 minuten) tot `86400` (24 uur). Daarna vervalt de factuur en kan deze niet meer worden betaald. Standaard: `3600` (1 uur). Voorbeeld: `3600`.

Response

JSON

{
  "state": 0,
  "result": {
    "uuid": "abc123-def456-...",
    "order_id": "ORDER-12345",
    "amount": "100.00",
    "currency": "USD",
    "amount_usd": "100.00",
    "exchange_rate": null,
    "url": "https://2328.io/pay/abc123-def456-...",
    "tg_deeplink": "https://t.me/my2328bot?start=pay_abc123-def456-...",
    "expires_at": "2026-01-11T21:00:00Z",
    "created_at": "2026-01-11T20:00:00Z",
    "payer_currency": "USDT",
    "payer_amount": "100.50",
    "network": "TRX-TRC20",
    "address": "TXYZabc123...",
    "payment_status": "check",
    "txid": null,
    "payment_amount": null,
    "qr": "data:image/png;base64,iVBORw0..."
  }
}

Verwijs de klant door naar result.url om de betaling te voltooien.
tg_deeplink — Telegram-bot-deeplink voor betaling via de Telegram MiniApp.
qr — base64-gecodeerde QR-code (data URI) van het stortingsadres. Aanwezig wanneer er al een adres is toegewezen (wanneer network samen met to_currency is ingesteld, of wanneer currency een cryptovaluta is); anders null.
txid, payment_amount — null totdat de klant betaalt. Worden ingevuld zodra de transactie on-chain is gedetecteerd. Luister naar de payment_status: paid-webhook om te weten wanneer.
exchange_rate — null als conversie nog niet van toepassing is (bijv. wisselkoers fiat → crypto is nog niet vastgelegd). Wordt ingevuld zodra een betalersvaluta is gekozen.

Credentials

Project UUIDAPI key

RequestPOST/v1/payment

curl -X POST https://api.2328.io/api/v1/payment \
  -H "Content-Type: application/json" \
  -H "User-Agent: MyShop/1.0 (+https://myshop.example)" \
  -H "project: YOUR_PROJECT_UUID" \
  -H "sign: YOUR_HMAC_SIGNATURE"

Response

Click Try it to see the response here.

Betalingsinformatie

Haal de huidige betalingsstatus op met uuid of order_id.

Verzoekparameters

Veld	Type	Vereist	Beschrijving	Waarden
`uuid`	string	ja*	Payment UUID (uit `result.uuid` bij aanmaken)
`order_id`	string	ja*	Je order-ID

Ten minste één van uuid of order_id is vereist.

RequestPOST/v1/payment/info

curl -X POST https://api.2328.io/api/v1/payment/info \
  -H "Content-Type: application/json" \
  -H "User-Agent: MyShop/1.0 (+https://myshop.example)" \
  -H "project: YOUR_PROJECT_UUID" \
  -H "sign: YOUR_HMAC_SIGNATURE"

Response

Click Try it to see the response here.

Betalingenlijst

Haal een lijst van alle betalingen op met filtering en paginering.

Verzoekparameters

Veld	Type	Vereist	Beschrijving
`status`	string	nee	Filteren op betalingsstatus (zie References)
`date_from`	date	nee	Begindatum (YYYY-MM-DD), bijv. `2026-01-01`
`date_to`	date	nee	Einddatum (YYYY-MM-DD), bijv. `2026-01-31`
`page`	int	nee	Paginanummer, standaard `1`
`per_page`	int	nee	Items per pagina, standaard `15`, max `5000`

RequestPOST/v1/payment/list

curl -X POST https://api.2328.io/api/v1/payment/list \
  -H "Content-Type: application/json" \
  -H "User-Agent: MyShop/1.0 (+https://myshop.example)" \
  -H "project: YOUR_PROJECT_UUID" \
  -H "sign: YOUR_HMAC_SIGNATURE"

Response

Click Try it to see the response here.