Blogue

Rechargement automatique : cessez de surveiller votre solde

Le rechargement automatique est un nouveau réglage facultatif. Activez-le et HonkIO regarnit votre solde à partir d'une carte enregistrée quand il baisse, et avant l'échéance du loyer mensuel de vos numéros. Il reste désactivé tant que vous ne le choisissez pas, et vous pouvez le désactiver en tout temps.

Un solde prépayé a un point faible : quelqu'un doit penser à le recharger. Jusqu'à aujourd'hui, cela voulait dire un courriel de solde bas, un détour par la page Facturation et un formulaire de carte, souvent au mauvais moment. Le rechargement automatique est une nouvelle option qui s'en occupe pour vous, si vous le voulez.

C'est votre choix

Le rechargement automatique est désactivé sur tous les comptes, et il le reste tant que vous ne l'activez pas vous-même. Nous n'enregistrons ni ne débitons jamais une carte de notre propre chef. Si vous préférez recharger à la main, ne faites rien : les recharges manuelles et les courriels de solde bas fonctionnent exactement comme hier.

Ce que ça fait

Si vous l'activez, vous choisissez deux chiffres sur la page Facturation : un seuil et un montant. Quand votre solde passe sous le seuil, HonkIO débite votre carte enregistrée du montant et l'ajoute à votre solde. Le réglage se lit comme une phrase :

Quand mon solde passe sous 10,00 $, ajouter 25,00 $.

Vos numéros restent actifs

Le loyer des numéros est prélevé sur votre solde une fois par mois. Quand le solde ne suffit pas, le numéro est suspendu, et un numéro suspendu finit par être libéré. Perdre un numéro que vos clients connaissent déjà est la façon la plus coûteuse d'oublier une recharge.

Le rechargement automatique regarde en avant. Dans les 24 heures avant l'échéance du loyer, il vérifie si votre solde le couvre. Sinon, il recharge d'abord, même si vous êtes encore au-dessus de votre seuil. Il le fait au plus une fois par échéance.

Vos envois continuent

Un message sans solde derrière lui est refusé. Avec le rechargement automatique, un solde qui passe sous votre seuil est regarni environ une minute plus tard : un après-midi chargé ne se termine plus par des envois refusés.

Une mise en garde, pour que personne ne soit surpris : votre solde est vérifié environ une fois par minute, et une grosse rafale peut encore l'amener à 0 $ entre deux vérifications. Choisissez un seuil qui laisse de la marge pour votre minute la plus occupée.

Vous gardez la main sur votre carte

  • Un seul débit par baisse : le montant est toujours au moins égal au seuil, donc une seule recharge ramène votre solde au-dessus
  • Vos limites tiennent toujours : chaque débit compte dans vos limites de recharge, et un débit qui les dépasserait est sauté
  • Aucune relance sur une carte refusée : si un débit échoue, le rechargement automatique se met en pause et nous vous écrivons. Rien d'autre n'est débité tant que vous ne le réactivez pas
  • Un reçu chaque fois : chaque débit envoie un courriel avec le crédit, la taxe et votre nouveau solde
  • Désactivé en un clic : désactivez-le sur la page Facturation et la carte enregistrée est retirée

Comment l'activer, si vous le voulez

Ouvrez Facturation dans le tableau de bord et trouvez Rechargement automatique. Réglez votre seuil et votre montant, cochez l'autorisation et payez votre première recharge. Ce paiement enregistre la carte, et votre banque peut vous demander de le confirmer une fois. Le plus petit seuil est de 5,00 $ et le plus petit montant, de 10,00 $. La taxe de vente s'ajoute à chaque débit, comme pour une recharge manuelle.

Tant que le rechargement automatique fonctionne, les courriels d'avertissement de solde bas cessent, puisque vous n'avez rien à faire. S'il est mis en pause, les avertissements reviennent.

Pour les développeurs

Les réglages ne se modifient que dans le tableau de bord : une clé d'API ne peut donc jamais augmenter ce qui est débité de votre carte. La lecture est ouverte à toute clé : GET /v1/auto-topup renvoie votre seuil et votre montant, la carte enregistrée, l'état de pause et sa raison, ainsi que les tentatives récentes.

sh
curl https://api.honkio.ca/v1/auto-topup \
  -H "Authorization: Bearer mk_live_YOUR_KEY"

Deux événements de webhook rapportent chaque résultat. account.auto_topup_succeeded indique ce qui a déclenché le débit, le crédit, la taxe, le total et votre nouveau solde. account.auto_topup_paused indique la raison. Les données d'une recharge réussie ressemblent à ceci :

json
{
  "attempt_id": "ata_a1b2c3d4e5f6a1b2c3d4e5f6",
  "trigger": "threshold",
  "amount_cents": 2500,
  "tax_cents": 325,
  "total_cents": 2825,
  "balance_cents": 3100
}

Les règles complètes se trouvent dans le guide des tarifs et des limites, et les champs des événements, sur la page des événements de webhook.

Envoyez votre premier message cet après-midi.