Zahlungen und Auszahlungen/Payment API

Payment API

Erstellen und verwalten Sie Kryptowährungs-Zahlungssitzungen mit der 2328.io Payment API.

Mit der Payment API können Sie Zahlungssitzungen erstellen, Kunden auf eine gehostete Checkout-Seite weiterleiten und den Zahlungsstatus verfolgen.

Zahlung erstellen

Erstellt eine Zahlungssitzung und gibt eine URL zurück, unter der der Kunde bezahlen kann.

Anfrageparameter

Feld	Typ	Pflicht	Beschreibung
`amount`	decimal	ja	Zahlungsbetrag in der Währung, z. B. `100.00`
`currency`	string	ja	Fiat-Währung (USD, EUR, RUB, …) oder Kryptowährung (USDT, TRX, BTC, …)
`order_id`	string	ja	Ihre Bestell-ID, z. B. `ORDER-12345` (max. 128 Zeichen)
`to_currency`	string	nein	Vorausgewählte Kryptowährung
`network`	string	nein*	Netzwerkcode (erforderlich, wenn `to_currency` gesetzt ist oder `currency` eine Kryptowährung ist)
`url_return`	string	nein	Weiterleitungs-URL nach der Zahlung, z. B. `https://your-site.com/return`
`url_success`	string	nein	Alternative zu `url_return`
`url_callback`	string	nein	URL für Webhook-Benachrichtigungen, z. B. `https://your-site.com/webhook`
`invite_code`	string	nein	Empfehlungscode
`fee_split`	decimal	nein	Anteil der Händlergebühr, der an den Zahler weitergegeben wird, 0–100 (%). 0 = der Händler trägt sie vollständig, 100 = der Zahler trägt sie vollständig. Überschreibt die Projekteinstellung. Beispiel: `30` (der Zahler übernimmt 30 % der Gebühr).
`price_markup`	decimal	nein	Aufschlag oder Rabatt auf den Rechnungsbetrag, −99 bis 100 (%). Überschreibt die Projekteinstellung. Beispiel: `5` (+5 %) oder `-10` (10 % Rabatt).
`description`	string	nein	Optionale Rechnungsbeschreibung (max. 200 Zeichen). Wird dem Zahler auf der Zahlungsseite angezeigt. Beispiel: `Premium plan — Order #12345`.
`ttl_seconds`	int	nein	Gültigkeitsdauer der Rechnung in Sekunden, von `300` (5 Minuten) bis `86400` (24 Stunden). Nach Ablauf dieser Zeit verfällt die Rechnung und kann nicht mehr bezahlt werden. Standard: `3600` (1 Stunde). Beispiel: `3600`.

Antwort

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

Leiten Sie den Kunden zu result.url weiter, um die Zahlung abzuschließen.
tg_deeplink — Telegram-Bot-Deeplink für die Zahlung über die Telegram MiniApp.
qr — Base64-codierter QR-Code (Data-URI) der Einzahlungsadresse. Vorhanden, wenn bereits eine Adresse zugewiesen wurde (wenn network zusammen mit to_currency gesetzt ist oder wenn currency eine Kryptowährung ist); andernfalls null.
txid, payment_amount — null, bis der Kunde bezahlt. Werden ausgefüllt, sobald die Transaktion on-chain erkannt wird. Lauschen Sie auf den Webhook payment_status: paid, um den Zeitpunkt zu erfahren.
exchange_rate — null, falls eine Umrechnung noch nicht relevant ist (z. B. wenn der Fiat-zu-Krypto-Kurs noch nicht festgesetzt wurde). Wird gefüllt, sobald eine Zahler-Währung gewählt ist.

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.

Zahlungsinformationen

Aktuellen Zahlungsstatus per uuid oder order_id abrufen.

Anfrageparameter

Feld	Typ	Pflicht	Beschreibung	Werte
`uuid`	string	ja*	Zahlungs-UUID (aus `result.uuid` bei der Erstellung)
`order_id`	string	ja*	Ihre Bestell-ID

Mindestens eines der Felder uuid oder order_id ist erforderlich.

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.

Zahlungsliste

Liste aller Zahlungen mit Filterung und Paginierung abrufen.

Anfrageparameter

Feld	Typ	Pflicht	Beschreibung
`status`	string	nein	Nach Zahlungsstatus filtern (siehe References)
`date_from`	date	nein	Startdatum (YYYY-MM-DD), z. B. `2026-01-01`
`date_to`	date	nein	Enddatum (YYYY-MM-DD), z. B. `2026-01-31`
`page`	int	nein	Seitennummer, Standard `1`
`per_page`	int	nein	Einträge pro Seite, 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.