PLATEFORME DÉVELOPPEUR
API de mise à jour des cartes
L'API de mise à jour des cartes maintient à jour les cartes enregistrées pour que la facturation récurrente survive à une expiration ou à une réémission. Les cartes sont remplacées sans cesse, et aucun de ces remplacements n'est une décision d'arrêter de payer; pourtant chacun produit un renouvellement refusé qui ressemble à un départ de client. RapidCents vérifie les cartes inscrites auprès des mises à jour des réseaux et applique les nouveaux numéros et dates au jeton existant, sans modifier le code de facturation ni contacter le titulaire. Les cartes non rafraîchies sont signalées.
- Sandbox avec cartes test
- Webhooks signés
- Erreurs typées et idempotence
- Support développeur dédié

Ce qui passe sur le fil
Où il se situe
Derrière le jeton, pas devant le débit. Vos systèmes continuent de référencer le même jeton; ce qui change dessous est la carte à laquelle il renvoie. Votre code de facturation n’a pas à le savoir.
Ce que vous inscrivez
Les moyens enregistrés que vous facturez régulièrement. L’inscription est l’étape volontaire : un jeton non inscrit n’est jamais rafraîchi, et c’est la raison la plus fréquente d’un service qui semble inactif.
Ce qui revient
Deux issues à traiter différemment. Une carte rafraîchie, appliquée automatiquement et rapportée pour savoir quels moyens ont changé et quand; et une exception, signalée parce qu’elle exige le client.
Quand l’utiliser
Abonnements et adhésions
Tout portefeuille de revenus récurrents a besoin de cartes tenues à jour. C’est l’outil qui rafraîchit ces identifiants pour que les adhésions et forfaits continuent de s’encaisser.
Plans de versements
Un plan qui casse au septième mois est pire qu’un plan jamais commencé : il faut joindre le client en cours d’engagement pour quelque chose qu’il n’a pas fait.
Commerce avec carte enregistrée
L’achat en un clic dépend d’une carte encore valide. RapidCents rafraîchit l’identifiant pour qu’un client qui revient puisse conclure la vente sur le moyen déjà enregistré.
Mettre en œuvre API de mise à jour des cartes
Inscrivez les moyens que vous facturez selon un calendrier, pas tous les jetons détenus.
Laissez les cartes rafraîchies s’appliquer au jeton automatiquement, sans changer votre code.
Lisez le rapport de mise à jour pour savoir quels moyens ont changé, et quand.
Dirigez les exceptions signalées vers une relance client avant le prochain débit prévu.
Mesurez les renouvellements récupérés pour justifier l’inscription par ce qu’elle a réellement sauvé.
Ce qui échoue, et comment vous l’apprenez
Attendre une couverture universelle
Le rafraîchissement dépend de la participation du réseau et de l’émetteur. Certaines cartes ne seront jamais rafraîchies, et une intégration qui l’ignore n’a aucun plan pour celles-là.
Ignorer la liste des exceptions
Les moyens signalés sont ceux qui exigent un humain. Les laisser échouer au cycle suivant gaspille l’avertissement et transforme un refus évitable en appel au support.
Conserver une copie des données de carte
Si vos systèmes gardent leur propre date d’expiration, elle se périme pendant que le jeton reste à jour, et votre validation se met à rejeter une carte qui aurait fonctionné.
En faire un substitut au recouvrement
Il supprime une cause d’échec, pas les échecs. Fonds insuffisants, blocages et comptes fermés exigent toujours une politique de relance et un moyen de joindre le client.
Sandbox par rapport à la production
Le mécanisme se teste, la couverture non
Le sandbox peut montrer une carte rafraîchie parvenir au jeton et un renouvellement réussir. Ce qu’il ne dit pas, c’est la fréquence sur votre propre portefeuille.
Exercez volontairement le chemin d’exception
La branche qui compte le plus est celle où la carte n’a pas pu être rafraîchie. Forcez-la en sandbox et confirmez que votre relance se déclenche vraiment.
L’inscription est cloisonnée par environnement
Les jetons ne franchissent pas la frontière : une inscription en sandbox prouve votre intégration sans effet en production. L’inscription en production est une étape distincte.
Questions sur API de mise à jour des cartes
Quelles cartes peuvent être rafraîchies?
La couverture dépend de la participation du réseau et de l’émetteur aux services de mise à jour. Elle est réellement partielle, ce qui explique que le chemin des exceptions fasse partie de la conception.
Le client doit-il agir?
Non. La mise à jour s’applique au jeton en arrière-plan, sans avis ni ressaisie : c’est tout l’intérêt, le client n’apprend jamais que son renouvellement allait échouer.
Et si une carte ne peut être rafraîchie?
Elle est signalée pour que vous demandiez un nouveau moyen avant le prochain débit. Traiter cette liste avant la date de facturation transforme un refus en simple mise à jour.
Mon code de facturation change-t-il lors d’une mise à jour?
Non. Vous continuez de facturer le même jeton; seule la carte derrière change. C’est pourquoi l’inscription vaut d’être faite tôt : le travail porte sur l’inscription et les exceptions, pas sur la facturation.
Est-ce la même chose que relancer un paiement échoué?
Non, et les deux règlent des problèmes distincts. La relance retente la même carte en espérant une cause passagère. La mise à jour change la carte, seule chose utile quand elle a été remplacée.
Faut-il inscrire toutes les cartes enregistrées?
Inscrivez ce que vous facturez sur un calendrier. Une carte gardée par simple commodité gagne peu, et restreindre l’inscription au portefeuille récurrent garde la liste d’exceptions assez courte pour être traitée.
Pourquoi la mise à jour des cartes semble-t-elle inactive?
Le plus souvent parce que les jetons n'ont jamais été inscrits. L'inscription est une étape volontaire, et une carte enregistrée non inscrite n'est jamais rafraîchie : c'est la raison la plus fréquente d'un service qui paraît inactif. L'inscription est aussi cloisonnée par environnement : la faire en sandbox valide l'intégration sans rien changer en production.
Ma base de données doit-elle conserver la date d'expiration de la carte?
Non. Conservez le jeton et, pour l'affichage, la marque et les quatre derniers chiffres. Une copie de la date d'expiration gardée dans vos systèmes se périme pendant que le jeton reste à jour, et votre propre validation se met alors à refuser une carte qui aurait été approuvée.
Suite de l’intégration

Un prélèvement d'abonnement RapidCents créé via l'API, sur le même moteur de facturation que le tableau de bord. API de paiements récurrents
Construisez abonnements, versements et logique de relance sur le même moteur de facturation.
Découvrir
L'API de tokenisation RapidCents renvoie un jeton de carte, pour que le logiciel marchand ne stocke jamais le PAN. API de tokenisation
Créez, réutilisez et retirez des jetons de paiement par API, sans jamais stocker de numéros de…
Découvrir
Une requête API RapidCents et sa réponse sur un poste développeur, avec le tableau de bord marchand et un terminal de test. API RapidCents
API REST pour les paiements, les remboursements, les clients, les jetons et les règlements.
Découvrir
Une erreur API RapidCents typée à l'écran, à côté de la vente sandbox refusée qui l'a produite. Erreurs
Codes d’erreur typés, consignes de relance et modèles d’idempotence.
Découvrir
Prochaine étape
Parlez à un spécialiste RapidCents
Fee Check de RapidCents lit un relevé de traitement et sépare l’interchange de la marge. Téléversez un relevé pour une analyse instantanée, ou ouvrez un compte marchand et commencez à encaisser sur un seul compte.
- Sans engagement
- Spécialistes paiement au Canada
- Téléversement sécurisé





