Partner-Integration
Direktlink: vorausgefüllte Anträge per API
Leg mit einem POST-Request einen vorausgefüllten Versicherungsantrag an und schick deine Kunden direkt zum Abschluss. Ein einziger API-Aufruf genügt.
Live-Demo
Stell die Parameter ein und sieh, wie der API-Aufruf dazu aussieht.
cURL-Befehl für diese Einstellungen
curl -X POST https://karlbikes.com/api/v1/proposals/prepare \
-H "Content-Type: application/json" \
-d '{
"token": "YOUR_PARTNER_TOKEN",
"locale": "de-ES"
}'Antwort der API (Beispiel)
{
"success": true,
"proposalId": "prop-a1b2c3d4",
"link": "https://karlbikes.com/de-ES/proposals/prop-a1b2c3d4"
}So funktioniert’s
1.Antrag anlegen
Dein System schickt einen POST-Request mit deinem Partner-Token und den Daten, die es schon kennt.
2.Link weitergeben
Die Antwort enthält den Link zum vorausgefüllten Antrag. Leite deinen Kunden dorthin weiter oder schick ihm den Link.
3.Kunde schließt ab
Dein Kunde prüft die Angaben, ergänzt, was fehlt, und schließt ab. Der Abschluss wird dir zugeordnet.
Der Request
Ein POST-Request an unsere API. Die Antwort enthält den fertigen Link für deinen Kunden.
cURL
Der kleinste Request: Nur der Partner-Token ist nötig.
curl -X POST https://karlbikes.com/api/v1/proposals/prepare \
-H "Content-Type: application/json" \
-d '{"token": "YOUR_PARTNER_TOKEN"}'JavaScript (fetch)
Der vollständige Request mit Rad- und Kundendaten.
const response = await fetch(
"https://karlbikes.com/api/v1/proposals/prepare",
{
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
token: "YOUR_PARTNER_TOKEN",
locale: "de-AT",
bike_desc: "Canyon Spectral 125 CF",
bike_value: 3499,
firstname: "Max",
lastname: "Mustermann",
email: "max@example.com",
}),
}
)
const { link } = await response.json()
// Redirect the customer to linkAPI-Parameter
Alle Felder im JSON-Body des Requests.
| Parameter | Pflicht | Standard | Beschreibung |
|---|---|---|---|
| token | Ja | keiner | Partner-Token zur Zuordnung der Leads (z.B. „pdemo“). |
| locale | Nein | de-AT | Sprache des Angebots. Unterstützt: de-AT, de-DE, de-IT, en-AT, en-DE, en-IT, it-AT, it-DE, it-IT, fr-AT, fr-DE, fr-IT, es-AT, es-DE, es-IT. Kurzcodes (de, en, it, fr, es) werden als Aliase auf das jeweilige *-AT akzeptiert. |
| bike_desc | Nein | keiner | Beschreibung des Fahrrads (z.B. Marke und Modell). |
| bike_value | Nein | keiner | Fahrradwert in EUR (0–100.000). |
| bike_frame | Nein | keiner | Rahmennummer des Fahrrads. |
| firstname | Nein | keiner | Vorname des Versicherungsnehmers. |
| lastname | Nein | keiner | Nachname des Versicherungsnehmers. |
| Nein | keiner | E-Mail-Adresse des Versicherungsnehmers. | |
| phone | Nein | keiner | Telefonnummer. |
| address | Nein | keiner | Straße und Hausnummer. |
| address2 | Nein | keiner | Adresszusatz (z.B. Stockwerk, Türnummer). |
| zip | Nein | keiner | Postleitzahl. |
| city | Nein | keiner | Ort. |
| country | Nein | keiner | EWR-Ländercode als ISO-3166-1 alpha-2 (z.B. AT, DE, IT). Zulässig sind alle 30 EWR-Staaten. |
Angebotsstatus abfragen
Frag jederzeit den aktuellen Stand eines Angebots ab, etwa um in deinem Kundenportal einen Versicherungsbereich ein- oder auszublenden. Du brauchst keinen Token, die Angebots-ID aus der Antwort genügt.
Anfrage
Ein GET-Request mit der Angebots-ID, mehr braucht es nicht.
curl https://karlbikes.com/api/v1/proposals/PROPOSAL_ID/statusJavaScript (fetch)
Den Status abfragen und die eigene Oberfläche danach richten.
const response = await fetch(
`https://karlbikes.com/api/v1/proposals/${proposalId}/status`,
)
const { status } = await response.json()
// Show the insurance section only once the policy is active
const showInsuranceSection = status === "BOUND"Antwort der API (Beispiel)
{
"proposalId": "550e8400-e29b-41d4-a716-446655440000",
"status": "BOUND"
}Mögliche Status-Werte
| Status | Bedeutung |
|---|---|
| PENDING | Angebot erstellt — der Kunde hat den Antrag noch nicht ausgefüllt. |
| DRAFTED | Vertragsentwurf erstellt — der Kunde hat die nötigen Angaben gemacht. |
| ACCEPTED | Der Kunde hat den Vertrag unterschrieben. |
| REJECTED | Das Angebot wurde abgelehnt. |
| BOUND | Polizze ausgestellt — die Versicherung ist aktiv. |
Ist die Angebots-ID unbekannt, antwortet die API mit HTTP 404.
Was du bekommst
Vorausgefüllte Anträge
Rad- und Kundendaten sind schon eingetragen, deine Kunden müssen weniger tippen.
Abschlüsse für dich
Jeder Abschluss über deinen Direktlink wird automatisch deinem Partnerkonto zugeordnet.
Aus jedem System
Funktioniert aus jedem Backend: mit cURL, mit fetch oder serverseitig in jeder Sprache.
Weitere Wege
Karl passt auch anders in deinen Verkauf. Im Partnerportal wartet dein Token mit fertigem Code.
Prämienrechner auf deiner Website
Zwei Zeilen Code, und deine Kunden sehen ihre Prämie direkt bei dir.
Zur Anleitung für den RechnerKarl-App für Shopify
Die Versicherung auf der Produktseite und nach dem Kauf in deinem Shop.
Zur Anleitung für ShopifyDein Token, dein Code
Im Partnerportal findest du deinen Partner-Token und den Code für den Rechner, mit deinem Token darin.
Zu den Integrationen
Noch kein Partner-Zugang?
Schreib uns, wir richten deinen Zugang innerhalb eines Werktags ein.