Schnittstelle · REST und Webhooks

Dokumentation unserer Schnittstelle für eigene Anbindungen

Die REST-Schnittstelle und unsere Webhooks stehen im bezahlten Tarif zur Verfügung. Das OpenAPI-Schema ist abrufbar, SDKs für TypeScript und Python sind in Vorbereitung.

Authentication

Bearer-Token via Authorization-Header. Token im EU Widerrufs-Button Pro Admin generieren (Settings → API). Basic- oder Premium-Tarif oder höher erforderlich.

Authorization: Bearer ewp_pk_live_xxxxx

Base URL

https://api.euwiderruf.com/v1

Endpoints

Method	Path	Beschreibung	Auth
GET	/api/v1/widerrufe	Liste aller Widerrufe (paginiert)	Bearer Token (Pro)
GET	/api/v1/widerrufe/:id	Einzelnen Widerruf abrufen	Bearer Token (Pro)
POST	/api/v1/widerrufe	Widerruf programmatisch erstellen	Bearer Token (Pro)
PATCH	/api/v1/widerrufe/:id	Status aktualisieren (z. B. erstattet)	Bearer Token (Pro)
POST	/api/v1/widerrufe/:id/refund	Refund auslösen (Shopify-Admin-Sync)	Bearer Token (Pro)
GET	/api/v1/audit-trail/export	CSV-Export des kompletten Audit-Trails	Bearer Token (Pro)

Webhooks

Echtzeit-Webhooks für Widerruf-Events. Konfiguration im EU Widerrufs-Button Pro Admin (Settings → Webhooks). HMAC-SHA256-Signatur für Authentizität.

Event	Trigger
widerruf.received	Neuer Widerruf eingegangen
widerruf.confirmed	Bestätigungs-Email an Kunden gesendet
widerruf.approved	Widerruf vom Händler genehmigt
widerruf.refunded	Refund ausgelöst und bestätigt
widerruf.rejected	Widerruf abgelehnt (mit Begründung)

Rate Limiting

Pro: 100 Requests/Minute, 10.000/Tag
Enterprise: 1.000 Requests/Minute, unbegrenzt/Tag

Rate-Limit-Headers in jeder Response:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1684567890

Beispiel-Request

curl -X GET https://api.euwiderruf.com/v1/widerrufe \
  -H "Authorization: Bearer ewp_pk_live_xxxxx" \
  -H "Content-Type: application/json"

Beispiel-Response

{
  "data": [
    {
      "id": "WR-J4L8K53N",
      "created_at": "2026-05-11T14:32:18Z",
      "order_number": "#1014",
      "customer_email_hash": "sha256:abc...",
      "items": [
        { "sku": "CARDIGAN-EICH-M", "qty": 1, "price": 189.00 }
      ],
      "amount": 189.00,
      "currency": "EUR",
      "status": "pending",
      "reason": "Falsche Größe"
    }
  ],
  "pagination": {
    "next_cursor": "WR-J4L8K53M",
    "has_more": true
  }
}

OpenAPI-Schema

Vollständige OpenAPI-3.1-Spezifikation: openapi.json

SDKs

TypeScript: npm install @ewp/sdk (Q3 2026)
Python: pip install ewp-sdk (Q4 2026)

Support

API-Support: api-support@euwiderruf.com. Antwortzeit für Pro/Enterprise: binnen 4h.

// Jetzt installieren

Den Zugang zur Schnittstelle bekommst du im Premium-Tarif freigeschaltet

Premium für 14,99 € pro Monat. Höhere Rate-Limits sind auf Anfrage möglich.

Kostenlos installieren