Aller au contenu principal
Sur cette page

DEUNA prend en charge les paiements récurrents par son propre moteur d'abonnement, votre système de facturation existant ou les téléchargements récurrents par lots. Cette page explique les concepts derrière les paiements récurrents, vous aide à choisir une approche, documente comment fonctionne le moteur d'abonnement DEUNA, montre comment gérer les plans et abonnements dans l'Admin, et liste ce qu'il faut valider avant de lancer.

Concepts clés#

Paiements récurrents, MIT et CIT

Paiements récurrents percevoir des frais à plusieurs reprises en vertu d'un accord avec un client. Le montant peut rester le même, comme une adhésion mensuelle, ou un changement, comme une facture d'utilité selon l'utilisation. La collecte automatique permet aux clients de payer les factures ultérieures sans effectuer manuellement chaque paiement.

Un Opérations d'origine marchande (MIT) est un paiement par carte que votre entreprise entreprend en vertu d'un accord préalable, sans la participation active du client à ce paiement. A transaction initiée par le client (CIT) est un paiement que le client effectue activement, y compris lorsqu'il choisit de payer avec une carte sauvegardée.

Réciproque décrit les collections répétées. Le MIT décrit qui a entrepris un paiement et sous quelle autorité. Les collections de cartes automatiques récurrentes sont une utilisation courante du MIT, mais les termes ne sont pas interchangeables. L'enregistrement d'une carte à lui seul n'autorise pas les futures collections.

Par exemple, un client s'engage pour une adhésion hypothétique de USD 10 mensuel. Ils paient activement les 10 premiers USD à l'inscription et acceptent les renouvellements mensuels automatiques. Ce paiement d'inscription est un CIT. Le mois suivant, votre entreprise recueille le renouvellement convenu sans que le client prenne des mesures : ce paiement est un MIT. La configuration peut également enregistrer une carte pour une première charge différée au lieu de charger à l'inscription.

Abonnements, facturation et traitement des paiements

  • Abonnement: l'accord continu entre un client et un produit ou un plan de service, y compris les conditions de prix et d'annulation.
  • Paiements récurrents: les redevances perçues en vertu de cet accord.
  • Logique de facturation: décide de quoi charger et quand.
  • Traitement des paiements: exécute cette instruction par l'intermédiaire d'un prestataire de paiement.

Choisir DEUNA pour le traitement des paiements ne transfère pas toutes les responsabilités de gestion d'abonnement à DEUNA. Les politiques, les taxes, les factures et la prestation de services demeurent sous votre responsabilité, sauf si elles sont intégrées séparément.

De la configuration à la collection ultérieure

La configuration et les flux de récupération sur cette page se concentrent sur les paiements de carte récurrents.

  1. Consentement: obtenir le consentement qui identifie votre entreprise et explique le montant ou le calcul, la fréquence de collecte ou de déclenchement, et les conditions d'annulation.
  2. Configuration de la carte: capture et jetonisation de la carte, avec authentification du client au besoin. La configuration peut inclure un paiement immédiat ou enregistrer la carte pour un premier frais différé.
  3. Décision de facturation: le propriétaire de la facturation détermine le montant et la date d'échéance de chaque recouvrement en vertu de l'accord.
  4. Traitement: DEUNA traite le paiement.
  5. Réconciliation: conciliez chaque résultat avec vos dossiers.
Diagramme de flux
1Customer consent2Card setup3Billing decision4DEUNA processes payment5Reconcile result
Marchand ou clientDEUNARésultat

Ce cycle de vie est conceptuel. Votre approche choisie détermine quels sont les calendriers de système ou les collections ultérieures.

Reconnaître votre scénario de paiement#

ScénarioCe que le client accepte deCe qui déclenche la collecte
Participation fixeUn plan de diffusion à 10 USD par moisLa date de facturation mensuelle
Facture variableUn utilitaire de 40 USD un mois et 60 USD le prochain, basé sur l'utilisation et les prix divulguésLe projet de loi devient exigible conformément au calendrier convenu

Pour les factures variables, indiquez quel système calcule le montant et confirmez que votre approche choisie appuie ces règles de facturation. Les deux scénarios exigent un accord préalable et une configuration de paiement supportée.

Choisir une approche DEUNA#

Choisissez en fonction de l'endroit où vos décisions de facturation appartiennent et comment votre système fournit des instructions de collecte.

ApprocheMeilleure solutionPropriétaire de la facturationComment la collecte atteint DEUNA
Moteur d'abonnement DEUNAVous voulez que DEUNA planifie des charges récurrentesMoteur DEUNA, selon vos termes configurésLe moteur déclenche des charges programmées
Moteur d'abonnement marchandVotre plateforme calcule et planifie déjà les facturesVotre moteur existantVotre système appelle l'API de paiement DEUNA
Téléchargement par lots récurrentVotre système d'héritage prépare les fichiers de collecteVotre système d'héritageVous soumettez des lots en utilisant des jetons de voûte DEUNA appropriés

Moteur d'abonnement DEUNA

Configurer les montants de facturation, les devises, les fréquences, le renouvellement automatique et les règles de réessayer. Les clients associés et les méthodes de paiement avec abonnements afin que le moteur puisse planifier et traiter les frais. Voir Comment fonctionne le moteur d'abonnement DEUNA ci-dessous et Gérer les plans et abonnements de l'Admin pour la configuration supportée, y compris les premiers frais reportés.

Le moteur et sa classification de paiement récurrent doivent être activés pour le commerçant et le magasin requis. Le support des processeurs, la portabilité des jetons, le lien des transactions réseau et les exigences d'authentification peuvent limiter les connexions éligibles pour les paiements ultérieurs.

Moteur d'abonnement marchand

Gardez votre logique de facturation et utilisez la API de paiement DEUNA pour la collecte. DEUNA fournit des itinéraires, des réapprovisionnements interfournisseurs admissibles et des services de paiement pour les flux MIT et PSD2, y compris les 3DS initiaux, le cas échéant. Configuration stratégies de paiement pour les connexions supportées.

DEUNA stocke également les identifiants de transactions réseau (NTID) pour les liaisons MIT ultérieures. Un jeton voûté identifie les identifiants de carte stockée; un historique de transactions réseau de référence NTID. Ni le consentement du client ne remplace, et le lien soutenu dépend du fournisseur et du réseau.

Téléchargement par lots récurrent

DEUNA peut soumettre des collections de lots à partir de jetons pour l'autorisation de processeur en ligne, lorsque cela est soutenu. Un lot modifie la façon dont les instructions arrivent; l'autorisation peut toujours se faire en ligne pour chaque paiement.

S'entendre sur le format de lot récurrent, la livraison, l'aptitude au jeton, les processeurs et l'échange de résultats par paiement avec DEUNA avant l'intégration.

Comment fonctionne le moteur d'abonnement DEUNA#

Le API des abonnements gère les abonnements clients aux plans que vous offrez. Utilisez-le pour contrôler les états d'abonnement et de planification et pour s'assurer que la facturation, l'activation, l'annulation et l'expiration sont effectuées correctement.

Vous pouvez également créer des plans et gérer des abonnements à partir du module Abonnements dans l'Admin. Voir Gérer les plans et abonnements de l'Admin pour le guide étape par étape.

Modèle de données

ObjectDescriptifContient
PlanProduit ou service offert aux clientsCode, nom, description, nom de groupe, montant, devise, intervalle de facturation, renouvellement automatique, début différé optionnel, état
AbonnementRelation entre un client et un planID unique, statut et dates de création, d'activation, d'annulation et d'expiration
Cycle de facturationPériode d'imputation d'un régimeUn des intervalles de facturation supportés (voir ci-dessous)

Début reporté

Un plan peut définir quand la première charge se produit au lieu de la charge immédiate, soit un jour spécifique du mois ou un nombre défini de jours après la création de l'abonnement. Un seul mode de démarrage différé peut être configuré par plan.

  • Aucune charge immédiate n'est imposée
  • Les frais sont programmés automatiquement selon la configuration du plan, sans appels API supplémentaires.
  • L'édition du plan n'est pas prise en charge et le début différé ne peut être modifié une fois que le plan a des abonnements actifs.

Consultez Créer un plan avec un démarrage différé pour les étapes de configuration Admin et les exemples.

Intervalles de facturation pris en charge

ValeurFréquence
DAILYQuotidiennement
WEEKLYSemaine
BIWEEKLYToutes les deux semaines
THIRTY_DAYSTous les 30 jours
SIXTY_DAYSTous les 60 jours
NINETY_DAYSTous les 90 jours
MONTHLYMensuel
BIMESTRIALTous les 2 mois
QUARTERLYTous les 3 mois
ANNUALAnnuellement
BIENNIALTous les 2 ans
TRIANNUAL3 fois par an
BIANNUAL2 fois par an

États-Unis

ÉtatDescriptif
activeLe plan est actif et disponible pour les nouveaux abonnements.
pendingLa création du plan a été tentée, mais n'a pas été achevée en raison d'une défaillance du système interne.

États abonnés

ÉtatDescriptif
pendingL'abonnement a été créé, mais le prix n'a pas encore été effectué. Il reste dans cet état jusqu'à ce que la charge réussisse ou échoue.
activeLe paiement a été effectué avec succès et l'abonnement a été validé.
canceledLe client ou le marchand a explicitement annulé l'abonnement avant son expiration.
expiredL'abonnement a pris fin, soit parce qu'il a atteint sa date d'expiration, soit parce qu'il a pris fin.

Gérer les abonnements avec l'API

Créer un abonnement

Utilisez la Créer un abonnement endpoint.

Liste des abonnements

Utilisez la Obtenir la liste des abonnements endpoint pour recevoir tous les abonnements pour un client.

Mettre à jour un abonnement ou une carte de paiement

Si le client met à jour sa carte, vous pouvez :

Capturez les cartes de remplacement par capture sécurisée de la carte afin que les données brutes de la carte restent hors de vos systèmes.

Annuler un abonnement

L'annulation modifie le statut de canceled. Vous pouvez spécifier:

  • Annulation à la fin du cycle de facturation actuel.
  • Annulation à la fin du cycle de renouvellement. Par exemple, un abonnement mensuel renouvelé pour un an est annulé lorsque l'année est terminée.
  • term_end: indique la fin du cycle actuel et génère un remboursement.
  • bill_date: indique le début du cycle suivant (24 heures après term_end) et génère un remboursement.

Pour les étapes correspondantes de l'Admin, voir Annuler un abonnement dans l'Admin.

Rétroactions automatiques

Le moteur d'abonnement comprend un mécanisme de réessayer pour gérer les défaillances temporaires, comme les problèmes de communication avec les processeurs de paiement lors de la facturation ou de l'activation de l'abonnement. Il assure que le paiement et l'activation sont complets sans intervention manuelle, même avec des défaillances intermittentes.

  • Réessayer automatiquement: si la charge ou l'activation de l'abonnement échoue, le système tente à nouveau le processus après un retard.
  • Défaut exponentiel: chaque réessayer augmente le temps d'attente entre les tentatives d'éviter de surcharger le système.
  • Limite de réessayer: lorsque les réticules atteignent un maximum configurable (par exemple, six tentatives), le système marque l'abonnement comme étant interrompu ou annulé (sur la base de votre propre configuration)
  • Notification: après des tentatives ratées, le système peut informer le client ou l'administrateur du statut d'abonnement et des échecs.
TentativeTemps d'attente
1—
25 minutes
360 minutes
45 heures
512 heures
624 heures

Gérer les plans et abonnements de l'Admin#

Les plans définissent les conditions de facturation d'un abonnement, y compris son prix, sa fréquence, son type de renouvellement et, en option, une date de début différée pour la facturation. Vous gérez les plans et les abonnements à la clientèle à partir de la Abonnements module dans l'Admin.

Champs de planification

CapacitéDescriptif
Nom du planNom commercial désignant le plan (Plan de base).
Description du planTexte facultatif précisant ce que le plan inclut (« Accès illimité au contenu premium »).
Nom du groupeGroupement interne pour des régimes semblables (prime, base, annuel). Utile pour l'organisation.
Code du planIdentificateur unique pour le plan de votre système (PLAN-001).
Montant du planLa valeur facturée dans chaque cycle de facturation.
DeviseDétermine la monnaie dans laquelle le régime est facturé.
FréquenceFréquence de facturation (hebdomadaire, mensuelle, annuelle, tous les 2 mois, etc.). Voir Intervalles de facturation pris en charge.
Renouvellement automatiqueDéfinit si les abonnements associés renouvellent à la fin de leur période.
Début reportéPermet de définir le moment où la première charge se produira, sans effectuer de paiement immédiat.
StatutActivité: disponible pour attribuer de nouveaux abonnements. En attente: le plan ne peut être attribué à de nouveaux abonnements.

Créer un plan avec un démarrage différé

  1. Dans le menu de la barre latérale, allez à Abonnements.
  2. Dans Abonnements, cliquez Plans.
  3. Cliquez Créer un plan.
  4. Remplissez les champs généraux du régime : nom, description, montant, monnaie, fréquence et renouvellement.
  5. Dans le Début reporté section, activer le "Démarrage de la facturation de l'horaire" toggle.
  6. Sélectionnez comment vous voulez définir le début de facturation :
    • Un jour spécifique du mois: la charge se produira le même jour chaque mois, peu importe le moment où l'abonnement a été créé.

      Exemple : si vous sélectionnez le jour 10 et que l'utilisateur s'inscrit le 3 octobre, la première charge sera le 10 octobre.

    • X jours après l'acquisition du régime: la charge se produira X jours après l'abonnement est créé.

      Exemple : si vous choisissez 7 jours et que l'abonnement commence le 5 octobre, la période de début de l'abonnement sera le 12 octobre.

  7. Enregistrer les modifications en cliquant sur Enregistre le plan.

Le début différé sera enregistré et appliqué à tous les abonnements créés avec ce plan.

Consulter les abonnements

Accédez au Abonnements onglet dans le module.

ChampDescriptif
Subscription IDIdentifiant d'abonnement unique.
Courriel du clientCourriel associé à l'abonnement.
Nom du planPlan actif auquel l'utilisateur est abonné.
Montant par factureValeur facturée périodiquement pour l'abonnement.
Début de l'abonnementDate à laquelle l'abonnement a été activé.
Dernière date de paiementDate de la dernière tentative de facturation.
StatutSituation actuelle : Active, Cancelled, Expired, Pending.

Vous pouvez filtrer les abonnements par courriel du client, date de création, ou nom du plan.

Informations sur l'abonnement

Cliquez sur n'importe quel abonnement dans la liste pour accéder à sa vue détaillée.

ChapitreDescriptif
Données clientInformations de base: nom, email, identification du client.
Informations sur l'abonnementSituation actuelle, dates clés, régime associé, montant et fréquence de facturation.
OpérationsListe des frais traités pour cet abonnement. Comprend l'ID de transaction, la date, le montant, le processeur et le statut de paiement.

Annuler un abonnement dans l'Admin

  1. Allez au Abonnements section dans le menu latéral.
  2. Dans le Abonnements onglet, rechercher le client par email ou ID.
  3. Cliquez sur l'icône du menu action ··· et sélectionnez Affichage de l'abonnement.
  4. Dans la vue de détail, cliquez sur le Actions bouton et sélectionnez Annuler.
  5. Un modal s'ouvrira avec l'option de sélectionner un Politique d'annulation. Il y a trois options :
Politique d'annulationDescriptif
Annuler immédiatementFin de l'abonnement tout de suite.
Annuler à la fin de la période de facturationMaintient l'abonnement actif jusqu'à la fin du cycle actuel. Il s'annule automatiquement à la fin de la période.
Annuler à une date précisePermet de définir manuellement une date d'annulation future. Jusqu'à cette date, l'abonnement reste actif.
  1. Si vous choisissez l'option de date spécifique, sélectionnez le jour sur le calendrier.
  2. (facultatif) Ajouter a motif d'annulation maintenir la traçabilité.
  3. Cliquez Confirmer l'annulation pour exécuter l'action.

Pause un abonnement

  1. Dans le détail de l'abonnement, cliquez sur le Actions bouton et sélectionnez Pause.
  2. Un modal apparaîtra où vous pouvez choisir le Politique de l'arrêt. Il y a trois options :
Politique de l'arrêtDescriptif
Pause immédiatementSuspend l'abonnement immédiatement. Aucun autre frais n'est généré tant qu'il n'est pas réactivé.
Pause à la fin de la période de facturationConserve l'abonnement actif jusqu'à la fin du cycle actuel, puis le met en pause automatiquement.
Pause à une date précisePrévoit la pause pour une date ultérieure. Jusqu'à ce jour, l'abonnement reste actif.
  1. Si vous choisissez l'option de date spécifique, sélectionnez le jour sur le calendrier.
  2. (Facultatif) Entrez une raison de pause si vous voulez enregistrer le contexte.
  3. Cliquez Confirmer la pause appliquer l'action.

Avantages pour les collections récurrentes#

Reprendre le timing en fonction du comportement

Les relevés de données de DEUNA basés sur l'IA apprennent du comportement historique des marchands et des clients à choisir le moment pour les tentatives de récupération admissibles. Par rapport à un programme de ré-essai fixe, cela peut cibler un moment où une condition récupérable peut avoir changé. Par exemple, une tentative ultérieure peut réussir après le rétablissement d'un solde insuffisant.

L'objectif est de récupérer les recettes et de réduire la curn involontaire: les clients perdus parce que les paiements échouent. L'agrément n'est pas garanti. Confirmez les fonctionnalités de récupération disponibles et les limites du fournisseur ou du réseau pour votre approche choisie.

Résilience par l'intermédiaire de plusieurs fournisseurs

Le routage par l'intermédiaire de fournisseurs éligibles configurés réduit la dépendance à l'égard d'une connexion de traitement unique. Traitement par défaut peut utiliser un deuxième processeur dans une cascade de recul. L'admissibilité dépend de l'échec, des règles du fournisseur et de l'aptitude symbolique à l'autre itinéraire. Le changement de fournisseur ne résout pas un solde insuffisant.

Si une collection n'a pas de succès confirmé, d'abord, distinguer un résultat non résolu d'un résultat qui permet le rétablissement :

Diagramme de flux
Unknown or pendingCustomer action requiredConfirmed failureNoneEligible providerEligible later attempt1Collection result2Reconcile originalpayment3Customer action4Allowed recovery5Stop automatic recovery6Provider fallback7Retry later
RésultatMarchand ou clientException ou arrêtFournisseur ou processeurRévision ou attente

Chaque chemin de récupération dépend de l'accord, des règles du fournisseur et de la configuration supportée:

  • Utilisez un flux client supporté seulement si autorisé. L'authentification du client doit renvoyer le client au flux supporté; les réticulations non surveillées ne peuvent pas le remplacer.
  • Le retour du fournisseur nécessite un fournisseur admissible configuré.
  • Une nouvelle collecte ultérieure doit être admissible et se produire au moment choisi.
  • Les relevés techniques après défaillance de communication suivent les règles documentées pour le paiement initial.

Coordonner la propriété de récupération entre votre système et DEUNA pour empêcher les processus indépendants de recueillir la même facture deux fois.

Données de carte moins sensibles dans vos systèmes

Utiliser la capture de carte de DEUNA et Coffre-fort de paiement pour tokenize les identifiants et garder les données de carte brutes hors de vos systèmes. Cela peut réduire les contrôles applicables en vertu de la norme de sécurité des données de l'industrie des cartes de paiement (SSD PCI). L'externalisation laisse toujours des responsabilités aux négociants, notamment en ce qui concerne la surveillance et la validation de la conformité par les fournisseurs. Voir PCI SSC orientation en matière d'externalisation.

Préparé pour adoption#

Confirmer le propriétaire de la facturation, le débit de consentement, les fournisseurs appuyés, l'admissibilité symbolique et la politique de recouvrement. Si une carte devient inutilisable, demandez au client de la remplacer par une capture sécurisée.

Pour des résultats incertains, réconciliez le paiement initial avant de commencer une nouvelle collecte. Suivez la conseils pour la demande d'idémpotent pour les relevés techniques après défaillances de communication. Utiliser des canaux de résultats documentés, y compris les hooks de web le cas échéant, pour mettre à jour vos dossiers.

Traitement des annulations

Distinguer une demande d'annulation de son heure d'entrée en vigueur : immédiate, fin de période ou une date spécifiée selon la politique configurée.

  • Arrêtez les nouvelles présentations à partir de ce moment, ou plus tôt si l'autorité chargée de l'imputation est révoquée ou expire.
  • Supprimer les collections non soumises touchées du système de planification.
  • Paiements réconciliés déjà présentés. Ne présumez pas que l'annulation arrête un paiement en vol; confirmez tout renversement ou remboursement en vertu de la politique applicable.

Valider avant le déploiement

Utilisez des cas de bac à sable supportés. Coordonner les cas non disponibles avec DEUNA avant le déploiement.

  • Configuration: confirmer le consentement retenu, un jeton approprié et l'achèvement de l'authentification requise.
  • Recouvrement: vérifier que le montant correspond à la décision de facturation et que chaque résultat se rapproche de vos dossiers.
  • Récupération: exercer les résultats admissibles de récupération et d'authentification-requis. Confirmer la politique convenue et le flux d'action client.
  • Résultat incertain: vérifier la réconciliation avant une autre tentative de collecte.
  • Annulation: vérifier la politique en vigueur, le consentement révoqué, la suppression des recouvrements en attente touchés et le rapprochement des paiements soumis.

Prochaines étapes#