Merchant API

Developers

API v1 für Checkout, Payments, Refunds, Bulk-Listings und Split Previews. Authentifizierung per Bearer Secret Key aus den Merchant-Einstellungen.

OpenAPI 3.1 JSON
Endpoints
POST/api/v1/checkout/sessionsCheckout Session erstellen
GET/api/v1/checkout/sessionsCheckout Sessions listen
GET/api/v1/paymentsPayments listen
GET/api/v1/payments/{id}Payment laden
POST/api/v1/refundsRefund erstellen
POST/api/v1/products/batchProdukt-Listings importieren (JSON/CSV)
POST/api/v1/splits/previewSplit Quote prüfen
GET/api/v1/insights/merchantImpact, Cashflow & Fraud-Signale
GET/api/v1/settlement-statements/monthlyMonatliches Settlement-PDF
POST/api/webhooks/merchantMerchant Event Webhook

Authentifizierung

Authorization: Bearer sk_live_…

Secret Key aus Dashboard → Einstellungen → API.

Rate Limit & Idempotenz

120 Requests / Minute pro API-Bucket
Idempotency-Key Header für POST-Endpoints
Checkout Sessions merchant-scoped
POST /api/v1/checkout/sessions — 201 Created
{
  "order_id": "DE-2204-A37F",
  "gross":    8900,
  "currency": "EUR",
  "rail":     "sepa_instant",
  "splits": [
    { "to": "brand_atlr_nord", "amount": 4132 },
    { "to": "sup_stoff_gmbh", "amount": 3293 }
  ]
}
Cirra Logo

Cirra verteilt Endkunden-Zahlungen direkt nach dem Checkout anhand hinterlegter Regeln — parallel an Brand, Supplier und Logistik. ESPR-vorbereitet und DATEV-fertig gebucht.

DE · EU · DSGVO · GoBD

Produkt
Zielgruppen
Ressourcen