API-Dokumentation – Florin+ Partner

🔒

Partner-Zugang erforderlich. Die vollständigen Dokumentationsseiten mit Code-Beispielen, Parameter-Referenz und Testumgebung sind nur für registrierte Partner verfügbar. Zur vollständigen Dokumentation → · Noch kein Partner? Jetzt registrieren

POST

/transfer_user

Flexibler Multi-Produkt-Endpunkt. Unterstützt alle 4 Onboarding-Ziele (Registrierung, Schuldnerberatung, Kredit, Kleinkredit). Drei registration_mode-Varianten: default, direct, realtime. Verarbeitung nicht-synchron.

Registrierung Schuldnerberatung Kleinkredit Kreditantrag Kein Echtzeit-Rückgabewert

Zur Dokumentation → EN

POST

/transfer_user_dispatch

Echtzeit-Endpunkt ausschließlich für die Florin+ Kreditkarte (Novum Bank). Übermittelt den Antrag synchron und liefert die initiale Bankentscheidung direkt in der API-Response zurück. Erfordert ausdrückliche Nutzereinwilligung.

Kreditkarte Novum Bank Echtzeit Bankentscheidung

Zur Dokumentation → EN

API-Vergleich auf einen Blick

Die wichtigsten Unterschiede zwischen den beiden Endpunkten.

Merkmal	/transfer_user	/transfer_user_dispatch
Produkte	Registrierung, Schuldnerberatung, Kleinkredit, Kreditantrag	Kreditkarte (Florin+ / Novum Bank) ausschließlich
Verarbeitung	Kein Echtzeit-Rückgabewert (E-Mail an Nutzer)	Synchron (Echtzeit-Response)
Bankentscheidung	–	✓ Direkt in der API-Response
registration_mode	`default` · `direct` · `realtime`	– (nur Kreditkarte)
Nutzereinwilligung	Empfohlen	✓ Pflicht vor API-Call
Min. Pflichtfelder	`token`, `email`	Alle Kreditantragsdaten + Einwilligungsfelder
Base URL	`https://app.mywage.de/api/1.1/wf/`

Registration Modes (/transfer_user)

Der Parameter registration_mode steuert, wie der Nutzer nach dem API-Call weitergeführt wird.

default

Standard E-Mail Flow

Nutzer erhält E-Mail mit Link zur Kontoeinrichtung. Antrag folgt danach. Geeignet für Batch-Verarbeitung und nicht-synchrone Workflows.

direct

Direktlink per E-Mail

E-Mail enthält direkten Link zum Antrag (nicht zur Kontoeinrichtung). Kürzerer Weg zum Abschluss. Kontoeinrichtung danach.

realtime

Echtzeit-Link in API-Response

Wie direct – zusätzlich kommt der Einmal-Link in der API-Response. Nutzer kann sofort weitergeleitet werden, ohne E-Mail-Schritt.

Onboarding Targets (/transfer_user)

Der Endpunkt unterstützt vier Ziele, konfiguriert über den Partner-Token. Separate Tokens pro Ziel auf Anfrage.

Target	Produkt	Schlüsselparameter	Provision (Sale-Modell)
👤 User Registration	MyWage-Konto	`first_name`, `last_name`, `email`, `birthday`, `address`	5–10 € (Antrag-Modell)
🧾 Debt Counseling	Schuldnerberatung	+ `net_income`, `total_debt`, `number_of_children`, `total_monthly_debt_payment`	10 € pro Antrag
🏦 Loan Application	Florin+ Kleinkredit	+ `preferred_loan_amount`, `preferred_loan_duration`, `net_income`, `iban`	50 € pro Sale
💳 Credit Card	Florin+ Kreditkarte	Vollständige Kreditantragsdaten (via /dispatch empfohlen)	80 € pro Sale

Quickstart – Minimaler API-Call

Das Minimum für einen gültigen /transfer_user Request. Je mehr Daten übergeben werden, desto höher die Conversion.

// Minimaler Request – Registrierung (default mode)
POST https://app.mywage.de/api/1.1/wf/transfer_user

{
  "token":             "DEIN_PARTNER_TOKEN",
  "email":             "nutzer@beispiel.de",
  "registration_mode": "direct",
  "partner_id":        "click_abc123",   // für Attribution
  "channel":           "website"
}

Vollständige Parameter-Referenz → /dispatch Dokumentation

MyWage Transfer APIs

Quickstart – Minimaler API-Call