Guide : affiliation avec l'API
Votre compte partenaire Kelki est aussi un compte de l'API. Les demandes créées avec vos identifiants de production portent automatiquement votre code partenaire (KA-…) : 20 % du prix hors taxe de chaque demande achetée par un professionnel vous revient, comme pour les modules intégrés.
Le principe
- Un seul compte. Le compte partenaire (code
KA-…) et le compte API (acc_…) sont le même compte. Votre espace partenaire vous donne votre secret développeur, qui ouvre l'espace développeur : clés de test d'abord, clés de production après validation par Kelki. - Rien à ajouter. Une demande créée par
POST /requestspuis confirmée par la personne (e-mail « Confirmer ma demande ») porte votre code. Les conversations de l'Agent (/agent/conversations) aussi : leur demande passe par la même confirmation. - Suivi. Vos demandes, leurs statuts (à confirmer, en cours, vendue, non vendue) et vos commissions s'affichent dans votre espace partenaire, sans aucune donnée personnelle.
En-tête facultatif Kelki-Affiliate
Pour l'écrire explicitement dans vos appels (journalisation, vérification), envoyez votre code dans l'en-tête Kelki-Affiliate. Il doit désigner le code de VOTRE compte : un autre code renvoie 403 insufficient_scope.
curl -X POST https://kelki.ai/api/v1/requests/req_01JC…/confirmation \
-H "Authorization: Bearer kk_live_…" \
-H "Kelki-Affiliate: KA-1042" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 3f1c…" \
-d '{"method": "email", "consent_given": true, "consent_text_version": "v2026-10-18"}'
Les règles de la commission
- Commission sur les demandes achetées et payées par un professionnel : 20 % du prix hors taxe, dans la devise de la vente.
- En attente 30 jours après la vente, puis validée ; virement mensuel dès 50 €, sur autofacture.
- Une même personne (téléphone ou e-mail) compte une fois sur 30 jours, tous canaux confondus ; le bac à sable (
kk_test_) ne crée jamais de commission. - Le texte d'accord, la confirmation par e-mail et les limites par contact restent ceux de l'API : consentement de la personne.
Les modules à copier-coller (formulaire « Rappelez-moi », Agent Kelki) et les conditions du programme : programme partenaires, conditions.