Environnements

Une seule adresse, deux environnements séparés. C'est votre clé qui choisit l'environnement : votre code ne change pas entre vos tests et la production.

	Sandbox	Production
Adresse	`https://api.coveraf.com`	`https://api.coveraf.com`
Clé API	`cvr_test_...`	`cvr_live_...`
Obtention	Dès l'ouverture de votre compte	Après vos tests et la signature de la convention
Base de données	Base séparée, données fictives	Données réelles
Prix	Tarifs réels (mêmes calculs)	Tarifs réels
Paiement Mobile Money	Simulé, aucun argent débité	Réel
Numéro de contrat	`TEST-CVR-API-...`	`CVR-API-...`
Documents	Documents de test, marqués « SANS VALEUR »	Documents officiels de l'assureur, vérifiables
Notifications	Vers votre adresse de test	Vers votre adresse de production

Savoir où l'on est

Chaque réponse indique l'environnement de deux façons :

l'en-tête X-Coveraf-Environnement : test ou live ;
le champ environnement de chaque objet (devis, souscription, contrat, événement).

GET /v1/ping avec une clé de test

{
  "ok": true,
  "environnement": "test",
  "partenaire": "Votre société",
  "signature_verifiee": false,
  "date_serveur": "2026-11-04T13:38:53.411Z"
}

Séparation stricte

Les deux environnements ne se voient pas : une clé de test ne lit jamais un contrat de production, et l'inverse. Un identifiant créé en sandbox renvoie introuvable en production.

Configurer votre application

Rangez la clé et le secret dans les variables d'environnement de votre serveur, une paire par environnement :

Serveur de test

COVERAF_CLE_API=cvr_test_...
COVERAF_SECRET=cvr_sig_...
COVERAF_SECRET_NOTIFICATIONS=cvr_whsec_...

Serveur de production

COVERAF_CLE_API=cvr_live_...
COVERAF_SECRET=cvr_sig_...
COVERAF_SECRET_NOTIFICATIONS=cvr_whsec_...

En production, tout est réel

Chaque souscription payée est un vrai contrat d'assurance et chaque paiement Mobile Money débite réellement votre client. Gardez la clé de test pour vos développements et vos démonstrations.

Pour commencer

Toutes les règles de la sandbox (numéros de paiement simulés, documents de test) sont sur la page Sandbox.