Beschreibung

Der Endpunkt nimmt Nutzerdaten als JSON entgegen und überträgt sie in die MyWage-Datenbank. Bei Erfolg gibt die API eine User-ID und einen Session-Token zurück. Fehler in den Daten oder Systemfehler werden mit entsprechenden Statuscodes und Fehlermeldungen beantwortet.

Onboarding Targets

Der Endpunkt unterstützt vier Onboarding-Ziele, die über den Partner-Token konfiguriert werden. Für mehrere Ziele können beim Account Manager separate Tokens angefordert werden.

Base URL

Endpoint

POST https://app.mywage.de/api/1.1/wf/transfer_user

Alle Parameter werden als JSON im Request-Body übergeben.

Pflichtparameter

Tracking & Flow-Steuerung

Persönliche Daten

Adresse

Beschäftigung

Finanzen

Kreditdaten

Schulden

Kleinkredit (Florin+ Kleinkredit)

Response

Erfolgreiche Antwort

{
  "status": "success",
  "response": {
    "valid_steps": [
      "first name", "last name", "gender",
      "birthday and place of birth", "family status",
      "job type", "address", "phone number", "schufa entry"
    ],
    "errors": [],
    "request_id": "1715353616817x...",
    "token": "bus|1715353616579x...|1715353616627x...",
    "user_id": "1715353616579x...",
    "expires": 86400
  }
}

Response bei registration_mode: realtime

Enthält zusätzlich das Feld link — einen Einmal-Link für den Nutzer, der direkt angezeigt oder weitergeleitet werden kann.

{
  "status": "success",
  "response": {
    "valid_steps": [...],
    "errors": [],
    "request_id": "XXX",
    "link": "ONE_TIME_LINK_FOR_CUSTOMER",  // Button/Link für den Nutzer
    "token": "bus|XXX|XXX",
    "user_id": "XXX",
    "expires": 86400
  }
}

Response-Felder

Beispiele

Minimaler Request

curl -X POST https://app.mywage.de/api/1.1/wf/transfer_user \
  -H "Content-Type: application/json" \
  -d '{
    "email": "nutzer@example.com",
    "token": "ihr_partner_token"
  }'

Vollständiger Request

POST https://app.mywage.de/api/1.1/wf/transfer_user
{
  "token": "TOKEN",
  "partner_id": "abc123",
  "channel": "website",
  "registration_mode": "direct",

  "first_name": "Max",
  "last_name": "Mustermann",
  "gender": "Männlich",
  "birthday": "1995.04.05",
  "place_of_birth": "Berlin",
  "nationality": "DE",
  "family_status": "Ledig",
  "number_of_children": 1,
  "iban": "DE89370400440532013000",

  "street": "Koppenplatz",
  "house_number": "88",
  "postcode": "10115",
  "city": "Berlin",
  "living_situation": "Miete",
  "adults_in_household": "1",
  "children_in_household": 1,

  "phone_number": "+4917666390000",
  "email": "max@example.com",

  "job_type": "Angestellter Privatwirtschaft",
  "employer_name": "Beispiel GmbH",
  "tax_class": "1",
  "net_income": 3500,

  "schufa_entry": "False",
  "preferred_loan_amount": 5000,
  "preferred_loan_duration": 36,
  "loan_purpose": "Privatkredit"
}

Fehlercodes