Flux utilisateur
Du prix au contrat en quatre étapes. Règle centrale : aucun contrat ni document n'existe avant que le paiement soit confirmé.
Les quatre étapes
- Devis :
POST /v1/devis. Vous envoyez les informations de tarification, l'API renvoie le prix, garanti 15 jours. - Conditions Générales :
GET /v1/produits/{code}/conditions-generales. Présentez-les à votre client avant qu'il paie (obligation légale). - Souscription :
POST /v1/souscriptions. Vous envoyez l'identité du client et les informations du contrat. L'API enregistre la demande et renvoie le montant à payer. - Paiement, selon le mode de votre compte. Dès qu'il est confirmé, le contrat est émis, actif, et ses documents sont disponibles.
Deux façons d'encaisser
Le mode est fixé pour votre compte par COVERAF et rappelé dans chaque souscription (mode_paiement).
États d'une souscription
| statut | Signification | Suite possible |
|---|---|---|
en_attente_paiement | Demande enregistrée, paiement attendu. | Payer (mode A ou B). |
payee | Paiement confirmé, contrat émis (champ contrat.numero). | Consulter le contrat et ses documents. |
expiree | Le devis a expiré avant paiement. | Demander un nouveau devis. |
Un devis ne peut donner qu'une souscription. La souscription expire en même temps que son devis (15 jours). Un paiement Mobile Money confirmé après cette date émet quand même le contrat : le client a payé.
La date d'effet
La couverture démarre à la date_effet demandée à la souscription (aujourd'hui par défaut, au plus tard dans 90 jours). Si le paiement arrive après cette date, elle démarre le jour du paiement : un client n'est jamais couvert pour une période passée.
Vous êtes responsable de transmettre à votre client ses Conditions Générales (avant paiement), puis ses Conditions Particulières et, pour un voyage, son attestation.