En cinq minutes : une clé test, une lettre de résiliation rendue par l’API, puis envoyée en recommandé avec accusé de réception, en bac à sable (rien n’est posté ni facturé).
1. Créez votre compte développeur
Connectez-vous puis ouvrez votre espace développeur : indiquez le nom de votre entreprise, et votre première clé vf_test_… s’affiche. Copiez-la tout de suite, elle ne sera plus jamais affichée. Placez-la dans une variable d’environnement :
export VITEF_API_KEY="vf_test_…"
2. Rendez une lettre du catalogue
La lettre resiliation-box pour le fournisseur sfr : l’adresse de SFR est connue, il suffit de l’identifiant client, du motif et de l’expéditeur.
{
"letter": "resiliation-box",
"provider": "sfr",
"plain": {
"title": "Lettre de résiliation SFR",
"sender": [
"Camille Martin",
"12 rue des Lilas",
"69003 Lyon"
],
"recipient": [
"SFR Résiliation",
"TSA 30103",
"69947 Lyon Cedex 20"
],
"place": "Lyon",
"date": "23 septembre 2026",
"subject": "Résiliation de mon abonnement SFR",
"body": [
"Madame, Monsieur,",
"Par la présente, je vous informe de ma décision de résilier mon abonnement internet SFR, identifiant client 0612345678, en raison de mon déménagement.",
"Conformément à l’article L224-39 du Code de la consommation, cette résiliation prendra effet dans un délai de 10 jours à compter de la réception de ce courrier.",
"Je vous remercie de m’en accuser réception et de m’indiquer les modalités de restitution du matériel.",
"Je vous prie d’agréer, Madame, Monsieur, l’expression de mes salutations distinguées."
],
"signature": "Camille Martin"
},
"text": "Camille Martin\n12 rue des Lilas\n69003 Lyon\n\nSFR Résiliation\nTSA 30103\n69947 Lyon Cedex 20\n\nLyon, le 23 septembre 2026\n\nObjet : Résiliation de mon abonnement SFR\n\nMadame, Monsieur,\n\nPar la présente, je vous informe de ma décision de résilier mon abonnement internet SFR, identifiant client 0612345678, en raison de mon déménagement.\n\nConformément à l’article L224-39 du Code de la consommation, cette résiliation prendra effet dans un délai de 10 jours à compter de la réception de ce courrier.\n\nJe vous remercie de m’en accuser réception et de m’indiquer les modalités de restitution du matériel.\n\nJe vous prie d’agréer, Madame, Monsieur, l’expression de mes salutations distinguées.\n\nCamille Martin",
"missing": [],
"complete": true
}
complete: true : la lettre est prête. Sinon, missing liste les champs à fournir.
{
"title": "Lettre de résiliation SFR",
"mode": "ar",
"modeLabel": "Recommandé avec AR",
"status": "paid",
"statusLabel": "Payée",
"step": 0,
"lastStep": 5,
"trackingNumber": "1A15760000001",
"createdAt": "2026-09-23T10:00:00.000Z",
"events": [
{
"step": 0,
"status": "paid",
"label": "Payée",
"at": "2026-09-23T10:00:00.000Z"
}
],
"id": "e1209b63-3764-49e3-bf9c-154e9be830da",
"orderId": null,
"recipient": [
"SFR Résiliation",
"TSA 30103",
"69947 Lyon Cedex 20"
],
"amountCents": 0,
"reference": "BAIL-2026-042",
"test": true,
"proofs": [],
"document": {
"title": "Lettre de résiliation SFR",
"sender": [
"Camille Martin",
"12 rue des Lilas",
"69003 Lyon"
],
"recipient": [
"SFR Résiliation",
"TSA 30103",
"69947 Lyon Cedex 20"
],
"place": "Lyon",
"date": "23 septembre 2026",
"subject": "Résiliation de mon abonnement SFR",
"body": [
"Madame, Monsieur,",
"Par la présente, je vous informe de ma décision de résilier mon abonnement internet SFR, identifiant client 0612345678, en raison de mon déménagement.",
"Conformément à l’article L224-39 du Code de la consommation, cette résiliation prendra effet dans un délai de 10 jours à compter de la réception de ce courrier.",
"Je vous remercie de m’en accuser réception et de m’indiquer les modalités de restitution du matériel.",
"Je vous prie d’agréer, Madame, Monsieur, l’expression de mes salutations distinguées."
],
"signature": "Camille Martin"
}
}
Avec une clé test, test: true et amountCents: 0 : l’envoi est simulé. Conservez son id pour le suivre.
4. Faites-le avancer et recevez vos webhooks
En bac à sable, les étapes ne viennent pas de La Poste : déclenchez-les vous-même avec POST /v1/test/mailings/{id}/advance. Si vous avez déclaré un webhook test, il reçoit chaque étape, signée comme en production.
Dans votre espace : demandez l’ouverture de la production (SIREN, adresse, usage) et créditez votre compte par carte. Après validation par notre équipe, créez une clé vf_live_… : le même code poste de vrais courriers, débités de votre crédit.