Relances

Quand un paiement échoue, QBill relance le client selon un calendrier que vous réglez, puis applique une action finale à l’abonnement. Ce guide couvre le calendrier, ce que fait chaque étape et comment le modifier.

Pourquoi QBill ne prélève jamais de lui-même

Avec Wave, le paiement fonctionne sur demande : le client valide lui-même chaque paiement. QBill ne prélève jamais le client de lui-même. Chaque relance porte donc un lien de paiement, et le client choisit quand payer.

Le calendrier

Par défaut, les relances partent 1, 3 et 7 jours après l’échec, puis l’action finale s’applique. Vous pouvez le changer :

  • jusqu’à 5 étapes ;
  • chaque étape est un nombre de jours entre 1 et 60 ;
  • les jours doivent être croissants (par exemple 2, 5, 10, jamais 5, 2).

Chaque étape

À chaque étape, QBill :

  1. envoie un e-mail au client avec le lien de paiement de la facture ;
  2. envoie à vos endpoints l’événement invoice.dunning_retry (son champ attempt indique quelle relance, voir Webhooks).

Le client peut payer via le lien à tout moment. Avec une clé de test, un Decline sur le paiement simulé démarre ce calendrier (voir Mode test).

La dernière étape

Une fois la dernière relance partie sans paiement, final_action décide :

final_action Résultat Événement
past_due (par défaut) L’abonnement passe en past_due et n’est pas renouvelé tant que sa facture n’est pas payée. subscription.past_due
cancel L’abonnement est annulé. subscription.cancelled

Le régler

Demande une clé secrète (ici qb_test_sk_…).

curl -X PATCH https://api.qbill.dev/v1/account/preferences \
  -H "x-api-key: qb_test_sk_…" \
  -H "content-type: application/json" \
  -d '{"dunning":{"schedule_days":[2,5,10],"final_action":"cancel"}}'

Ces réglages sont ceux du compte entier : ils s’appliquent aux abonnements live comme à ceux de la sandbox, donc les modifier avec une clé de test change aussi le comportement en production.

Le réglage par défaut est { "schedule_days": [1, 3, 7], "final_action": "past_due" }. Voir aussi Factures et paiements pour le lien de paiement et le renvoi d’une facture.

← Factures et paiementsUsage →