Intégration partenaire
Lien direct : des propositions préremplies par API
Crée une proposition d’assurance préremplie avec une requête POST et envoie tes clients directement à la souscription. Un seul appel d’API suffit.
Démo en direct
Règle les paramètres et vois à quoi ressemble l’appel d’API correspondant.
Commande cURL pour ces réglages
curl -X POST https://karlbikes.com/api/v1/proposals/prepare \
-H "Content-Type: application/json" \
-d '{
"token": "YOUR_PARTNER_TOKEN",
"locale": "fr-DE"
}'Réponse de l’API (exemple)
{
"success": true,
"proposalId": "prop-a1b2c3d4",
"link": "https://karlbikes.com/fr-DE/proposals/prop-a1b2c3d4"
}Comment ça marche
1.Créer la proposition
Ton système envoie une requête POST avec ton jeton partenaire et les données qu’il connaît déjà.
2.Transmettre le lien
La réponse contient le lien vers la proposition préremplie. Redirige ton client vers ce lien ou envoie-le-lui.
3.Le client souscrit
Ton client vérifie les données, complète ce qui manque et souscrit. La souscription t’est attribuée.
La requête
Une requête POST à notre API. La réponse contient le lien prêt à l’emploi pour ton client.
cURL
La requête minimale : seul le jeton partenaire est nécessaire.
curl -X POST https://karlbikes.com/api/v1/proposals/prepare \
-H "Content-Type: application/json" \
-d '{"token": "YOUR_PARTNER_TOKEN"}'JavaScript (fetch)
La requête complète avec les données du vélo et du client.
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 linkParamètres de l’API
Tous les champs du corps JSON de la requête.
| Paramètre | Obligatoire | Valeur par défaut | Description |
|---|---|---|---|
| token | Oui | aucune | Jeton partenaire qui t’attribue les leads (p. ex. « pdemo »). |
| locale | Non | de-AT | Langue de l’offre. Prises en charge : 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. Les codes courts (de, en, it, fr, es) sont acceptés comme alias du *-AT correspondant. |
| bike_desc | Non | aucune | Description du vélo (p. ex. marque et modèle). |
| bike_value | Non | aucune | Valeur du vélo en EUR (0–100 000). |
| bike_frame | Non | aucune | Numéro de cadre du vélo. |
| firstname | Non | aucune | Prénom du preneur d’assurance. |
| lastname | Non | aucune | Nom du preneur d’assurance. |
| Non | aucune | Adresse e-mail du preneur d’assurance. | |
| phone | Non | aucune | Numéro de téléphone. |
| address | Non | aucune | Rue et numéro. |
| address2 | Non | aucune | Complément d’adresse (p. ex. étage, numéro de porte). |
| zip | Non | aucune | Code postal. |
| city | Non | aucune | Localité. |
| country | Non | aucune | Code pays de l’EEE au format ISO 3166-1 alpha-2 (p. ex. AT, DE, IT). Les 30 États de l’EEE sont acceptés. |
Consulter le statut d’une offre
Consulte à tout moment l’état actuel d’une offre, par exemple pour afficher ou masquer une rubrique assurance dans ton espace client. Aucun jeton n’est nécessaire : l’identifiant de l’offre reçu dans la réponse suffit.
Requête
Une requête GET avec l’identifiant de l’offre, rien de plus.
curl https://karlbikes.com/api/v1/proposals/PROPOSAL_ID/statusJavaScript (fetch)
Consulter le statut et adapter ta propre interface en conséquence.
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"Réponse de l’API (exemple)
{
"proposalId": "550e8400-e29b-41d4-a716-446655440000",
"status": "BOUND"
}Valeurs de statut possibles
| Statut | Signification |
|---|---|
| PENDING | Offre créée — le client n’a pas encore rempli la proposition. |
| DRAFTED | Projet de contrat créé — le client a fourni les informations nécessaires. |
| ACCEPTED | Le client a signé le contrat. |
| REJECTED | L’offre a été refusée. |
| BOUND | Police émise — l’assurance est active. |
Si l’identifiant de l’offre est inconnu, l’API répond par HTTP 404.
Ce que tu obtiens
Des propositions préremplies
Les données du vélo et du client sont déjà saisies, tes clients ont moins à taper.
Des souscriptions pour toi
Chaque souscription faite via ton lien direct est attribuée automatiquement à ton compte partenaire.
Depuis n’importe quel système
Fonctionne depuis n’importe quel backend : avec cURL, avec fetch ou côté serveur dans n’importe quel langage.
Autres possibilités
Karl s’intègre aussi autrement à tes ventes. Ton jeton et un code prêt à l’emploi t’attendent dans le portail partenaire.
Calculateur de prime sur ton site
Deux lignes de code, et tes clients voient leur prime directement chez toi.
Vers le guide du calculateurApplication Karl pour Shopify
L’assurance sur la page produit et après l’achat dans ta boutique.
Vers le guide ShopifyTon jeton, ton code
Dans le portail partenaire, tu trouves ton jeton partenaire et le code du calculateur, avec ton jeton déjà dedans.
Vers les intégrations
Pas encore d’accès partenaire ?
Écris-nous, nous mettons en place ton accès en un jour ouvré.