Zum Hauptinhalt springen

Quickstart

5 Schritte zur ersten Forderung mit CashMich.

1. Registrieren & Email verifizieren

Erstellen Sie ein Konto auf cashmich.com/register. Bestätigen Sie Ihre E-Mail-Adresse über den Link in der Verifizierungs-Email.

2. API Key erstellen

Navigieren Sie zu Einstellungen → API Keys (/settings/api-keys). Erstellen Sie einen neuen API Key. Format: cm_live_XXXXXXXXXX. Speichern Sie den Key sicher — er wird nur einmal angezeigt.

3. CLI installieren

bash
npm i -g cashmich
cashmich auth login --api-key cm_live_YOUR_KEY_HERE

Alternativ ohne globale Installation:

bash
npx cashmich auth login --api-key cm_live_YOUR_KEY_HERE

4. Erste Forderung erstellen

Per CLI:

bash
cashmich claims create \
  --creditor-name "Ihre Firma GmbH" \
  --creditor-iban "AT611904300234573201" \
  --debtor-name "Max Mustermann" \
  --debtor-email "max@example.com" \
  --amount 250.00 \
  --invoice-number "RE-2026-001"

Per curl:

bash
curl -X POST https://api.cashmich.com/api/v1/claims \
  -H "Authorization: Bearer cm_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "creditorName": "Ihre Firma GmbH",
    "creditorIban": "AT611904300234573201",
    "debtorName": "Max Mustermann",
    "debtorEmail": "max@example.com",
    "amount": 250.00,
    "invoiceNumber": "RE-2026-001"
  }'

5. Status prüfen

Per CLI:

bash
cashmich claims list
cashmich claims get <claim-id>

Per curl:

bash
curl https://api.cashmich.com/api/v1/claims \
  -H "Authorization: Bearer cm_live_YOUR_KEY_HERE"

Ohne Anmeldung testen: Sandbox

Sie möchten die API ausprobieren, bevor Sie sich registrieren? Der Sandbox-Endpunkt gibt Ihnen sofort einen kurzlebigen API-Key (60 Minuten gültig), ganz ohne Konto:

bash
curl -X POST https://api.cashmich.com/api/v1/sandbox/key

Die Antwort enthält apiKey (Format cm_live_…) sowie fertige curl-Beispiele. Verwenden Sie den Key wie einen echten Key:

bash
# Key holen und direkt verwenden
KEY=$(curl -s -X POST https://api.cashmich.com/api/v1/sandbox/key | jq -r .apiKey)

# Forderung anlegen (Demo-Daten)
curl -X POST https://api.cashmich.com/api/v1/claims \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"creditorName":"Demo GmbH","creditorIban":"AT483200000012345864","debtorName":"Max Mustermann","debtorEmail":"max@example.com","amount":250}'

# Forderungen auflisten (inkl. vorgefertigter Demo-Forderungen)
curl https://api.cashmich.com/api/v1/claims \
  -H "Authorization: Bearer $KEY"

Wichtig zur Sandbox:

  • Isoliert: Der Key gehört zu einem eigenen Demo-Mandanten und kann keine echten Daten sehen oder ändern.
  • Keine echten Nachrichten: Kein Schuldner wird kontaktiert — alle E-Mails/SMS werden unterdrückt.
  • Nur Lesen + Anlegen: Berechtigungen auf claims:read + claims:create beschränkt.
  • Streng limitiert: 10 Keys pro Stunde und IP, 20 Requests/Minute für die gesamte Sandbox.
  • Kurzlebig: Der Key läuft nach 60 Minuten ab. Für Produktion einen echten Key erstellen (siehe Schritt 2).

Häufige Fehler

  • 401 Unauthorized: API Key prüfen — Format muss cm_live_ sein.
  • 422 Validation Error: Pflichtfelder: creditorName, creditorIban, debtorName, amount.
  • 429 Too Many Requests: Rate Limit erreicht — kurz warten und erneut versuchen.
KI-gestützt
Schuldnerfreundlich
DSGVO-konform
€Keine Vorabkosten

Newsletter abonnieren

© 2026 CashMich. Alle Rechte vorbehalten.

Alle Systeme betriebsbereit

Cookies

Wir nutzen Cookies für Betrieb und Verbesserung.

Mehr in der Datenschutzerklärung.