Betalningar och uttag/Payment API

Payment API

Skapa och hantera betalningssessioner för kryptovalutor med 2328.io Payment API.

Payment API:et låter dig skapa betalningssessioner, omdirigera kunder till en värdbaserad kassa och spåra betalningsstatus.

Skapa betalning

Skapar en betalningssession och returnerar en URL där kunden kan betala.

Parametrar i förfrågan

Fält	Typ	Obligatoriskt	Beskrivning
`amount`	decimal	ja	Betalningsbelopp i den angivna valutan, t.ex. `100.00`
`currency`	string	ja	Fiatvaluta (USD, EUR, RUB, …) eller kryptovaluta (USDT, TRX, BTC, …)
`order_id`	string	ja	Ditt order-ID, t.ex. `ORDER-12345` (upp till 128 tecken)
`to_currency`	string	nej	Förvald kryptovaluta
`network`	string	nej*	Nätverkskod (krävs om `to_currency` är satt eller `currency` är en kryptovaluta)
`url_return`	string	nej	URL att omdirigera till efter betalning, t.ex. `https://your-site.com/return`
`url_success`	string	nej	Alternativ till `url_return`
`url_callback`	string	nej	URL för webhook-notifieringar, t.ex. `https://your-site.com/webhook`
`invite_code`	string	nej	Hänvisarkod
`fee_split`	decimal	nej	Andel av handlaravgiften som skickas vidare till betalaren, 0–100 (%). 0 = handlaren betalar fullt ut, 100 = betalaren betalar fullt ut. Åsidosätter inställningen på projektnivå. Exempel: `30` (betalaren täcker 30 % av avgiften).
`price_markup`	decimal	nej	Påslag eller rabatt på fakturabeloppet, −99 till 100 (%). Åsidosätter inställningen på projektnivå. Exempel: `5` (+5 %) eller `-10` (10 % rabatt).
`description`	string	nej	Valfri fakturabeskrivning (max 200 tecken). Visas för betalaren på betalningssidan. Exempel: `Premium plan — Order #12345`.
`ttl_seconds`	int	nej	Fakturans livslängd i sekunder, från `300` (5 minuter) till `86400` (24 timmar). Efter denna tid förfaller fakturan och kan inte längre betalas. Standard: `3600` (1 timme). Exempel: `3600`.

Svar

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

Omdirigera kunden till result.url för att slutföra betalningen.
tg_deeplink — deeplink till Telegram-bot för betalning via Telegram MiniApp.
qr — Base64-kodad QR-kod (data URI) för inbetalningsadressen. Finns när en adress redan tilldelats (när network är satt tillsammans med to_currency, eller när currency är en kryptovaluta); annars null.
txid, payment_amount — null tills kunden betalar. Fylls i när transaktionen upptäcks on-chain. Lyssna på webhooken payment_status: paid för att veta när.
exchange_rate — null om konvertering ännu inte är tillämplig (t.ex. om växelkursen fiat → krypto inte har låsts än). Fylls i när en betalningsvaluta valts.

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.

Betalningsinformation

Hämta aktuell betalningsstatus med uuid eller order_id.

Parametrar i förfrågan

Fält	Typ	Obligatoriskt	Beskrivning	Värden
`uuid`	string	ja*	Betalningens UUID (från `result.uuid` vid skapandet)
`order_id`	string	ja*	Ditt order-ID

Minst en av uuid eller order_id är obligatorisk.

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.

Betalningslista

Hämta en lista över alla betalningar med filtrering och paginering.

Parametrar i förfrågan

Fält	Typ	Obligatoriskt	Beskrivning
`status`	string	nej	Filtrera efter betalningsstatus (se References)
`date_from`	date	nej	Startdatum (YYYY-MM-DD), t.ex. `2026-01-01`
`date_to`	date	nej	Slutdatum (YYYY-MM-DD), t.ex. `2026-01-31`
`page`	int	nej	Sidnummer, standard `1`
`per_page`	int	nej	Antal per sida, standard `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.