Passage en production

Votre intégration fonctionne en sandbox ? Voici ce que COVERAF vérifie avec vous avant de vous remettre votre clé de production.

1. Vos tests en sandbox

COVERAF voit vos appels de test (sans les données de vos clients) et vérifie avec vous chacun de ces points :

1. Devis : Votre application obtient un devis pour chaque offre que vous vendrez, et affiche les erreurs de saisie (erreur.details) à votre client.
2. Conditions Générales : Elles sont présentées au client avant son paiement.
3. Souscription : Chaque souscription porte une Idempotency-Key ; un double clic ne crée rien en double.
4. Paiement réussi : Le contrat apparaît chez vous dès la notification contrat.emis (ou à la consultation).
5. Paiement échoué : Mode B : avec 0700000002, votre client voit un message clair et peut réessayer.
6. Notifications : Votre serveur vérifie la signature, répond 2xx rapidement et ignore les doublons (POST /v1/webhooks/test).
7. Documents : Votre client reçoit ses Conditions Particulières (et son attestation pour un voyage).
8. Erreurs : Les erreurs 5xx et 429 sont réessayées ; les autres sont journalisées avec leur requete_id.
9. Sécurité : La clé et les secrets sont dans les variables d'environnement de votre serveur, jamais dans votre application mobile ni dans votre dépôt de code.

2. La convention

Une convention de partenariat signée précise les offres que vous distribuez, votre commission et, si vous encaissez vous-même vos clients (mode A), les modalités et délais de reversement des primes.

3. Vos accès de production

• Vous recevez une clé cvr_live_ et son secret, affichés une seule fois ;
• vous communiquez votre adresse de notification de production et recevez son secret ;
• recommandé : les adresses IP de vos serveurs, pour que votre clé ne fonctionne que depuis chez vous.

Remplacez la clé et les secrets dans votre configuration : votre code ne change pas.

4. Données personnelles

Vous transmettez à COVERAF des données personnelles de vos clients (identité, téléphone, dates de naissance, informations de santé déclarées). Vous devez les avoir collectées loyalement et informé vos clients de leur transmission à OPTIMUS AFRICA (éditeur de COVERAF) et à la compagnie d'assurance, pour la souscription et la gestion de leur contrat.

Durées de conservation côté API :

• devis et demandes de souscription jamais payés : effacés 30 jours après leur expiration ;
• journal technique de vos appels (sans les données de vos clients) : 12 mois ;
• contrats émis : conservés pour la durée légale de gestion des contrats d'assurance.