.png)
Abonnements
(facturation périodique)
Un abonnement permet de mettre en place une série de transactions automatisées gérées par Moneris. Moneris traitera ces transactions pour le compte de la commerçante ou du commerçant selon le calendrier convenu entre celle-ci ou celui-ci et sa ou son client. Cette fonctionnalité est souvent utilisée pour les services d’abonnement assortis de paiements fixes à intervalles réguliers.
1. Paiements périodiques gérés par Moneris, ou par la commerçante ou le commerçant
Comme les séries de paiements créées par les endpoints (points de terminaison) sont gérées par Moneris, il y a des points importants à savoir sur la façon de les utiliser.
Mis à part le paiement initial, qui est configuré séparément à partir de la valeur indiquée dans le champ oneTimeAmount, tous les autres paiements de la série sont du même montant, qui est indiqué dans le champ billingAmount. Le montant d’une série de paiements peut être modifié au besoin, mais si vous devez configurer une série de paiements dont le montant varie, il pourrait être plus facile pour vous de gérer cette série vous-même.
Le calendrier des paiements est fixe et plusieurs paramètres ne peuvent pas être modifiés une fois le calendrier configuré. Vous pouvez prolonger une série de paiements en ajoutant des paiements supplémentaires OU interrompre une série de paiements pendant un certain temps. Par contre, vous ne pouvez pas modifier les types d’intervalles entre les paiements ni la fréquence des paiements; si un calendrier comprend des paiements aux quatre mois, il ne peut pas être modifié de manière à comprendre des paiements aux deux semaines. Dans le cas d’un abonnement comprenant des paiements à intervalles irréguliers, vous devez utiliser l’endpoint (point de terminaison) de paiement principal pour chaque transaction.
2. Collecte des données du titulaire de carte
Avant de pouvoir envoyer l’appel entre les serveurs à l’API à des fins de paiement, vous devrez récolter les données de la carte de crédit du titulaire pour votre transaction. Trois options sont offertes :
Transformation en jetons hébergé : Ce service de Moneris intègre un champ pour la saisie des données à votre site Web hébergé sur les systèmes de Moneris et renvoie un jeton temporaire à utiliser lors du paiement. Il évite à votre site Web d’avoir à directement gérer les données de carte sensibles et enlève le fardeau lié à la certification de conformité aux exigences de l’industrie des cartes de paiement (PCI).
Recouvrement du commerçant : Vous pouvez recueillir directement les numéros de carte de crédit, les dates d’expiration et les données de vérification de carte du titulaire de carte sur votre site Web, en plus de gérer ces renseignements tout au long du processus de paiement. Pour y arriver, vous devez vous conformer aux exigences de la PCI pour assurer la sécurité des données.
Mode de paiement au dossier : Si vous avez sauvegardé un mode de paiement pour ce titulaire de carte, notamment un jeton permanent dans le service de chambre forte de Moneris ou un mode de paiement par l’entremise de notre API, vous n’avez pas besoin de le recueillir de nouveau pour les transactions subséquentes et pouvez suivre les prochaines étapes. Durant l’appel à l’API, vous pouvez utiliser ces modes pour remplacer la saisie du titulaire de carte.
3. Authentification 3-D Secure
Si les fonctions 3-D Secure sont déjà activées dans votre compte de commerçant, suivez les étapes d’implémentation ici avant débuter le processus de la transaction de paiement.
Moneris recommande de faire l’authentification 3-D Secure avant d’amorcer la transaction de paiement. Cette fonctionnalité de prévention de la fraude électronique est conçue pour réduire la fraude avec carte absente en évaluant le risque en fonction des données de la transaction et de l’appareil, tout en prenant en charge d’autres mesures d’atténuation du risque, telles qu’une contestation du titulaire de carte. Dans certains cas, un transfert de responsabilité a lieu pour certaines rétrofacturations liées à une fraude avec carte absente, ce qui permet au commerçant d’offrir des biens et des services avec assurance.
4. Création d’un calendrier des paiements pour un abonnement
Votre serveur envoie une demande à Moneris sous forme d’appel à l’API comprenant les détails du calendrier des paiements périodiques. Cet appel utilise l’endpoint (point de terminaison) POST/des abonnements, avec des éléments de contexte importants relatifs aux paramètres suivants :
“oneTimeAmount”
L’inclusion d’un montant dans ce champ génère un paiement supplémentaire traité immédiatement avant la création du calendrier des paiements de l’abonnement. Le montant de ce paiement peut être différent de celui des autres paiements, qui est indiqué dans le champ billingAmount. Souvent, le champ oneTimeAmount est utilisé dans des cas où la première transaction inclut des frais supplémentaires, par exemple des frais initiaux d’adhésion de 200 $ (montant unique), en plus de frais d’abonnement annuels de 60 $ (montant récurrent).
Lorsqu’aucun montant n’est indiqué dans ce champ, Moneris procède automatiquement à la validation des données sur le mode de paiement.
“billingIntervalUnit”
Ce champ permet de définir les types d’intervalles entre les paiements, soit DAY (jour), WEEK (semaine) ou MONTH (mois).
Pour configurer une série de paiements à effectuer le dernier jour de chaque mois, utilisez END_OF_MONTH (fin de mois); Moneris ajustera automatiquement les dates des paiements périodiques pour qu’elles correspondent au dernier jour de chaque mois (qu’il s’agisse d’un mois de 28, de 29, de 30 ou de 31 jours). Évitez d’utiliser l’intervalle MONTH (mois) pour les paiements à effectuer le dernier jour du mois, car les systèmes de Moneris seront obligés de s’adapter lors des mois comportant un nombre différent de jours.
“billingIntervalFrequency”
Ce champ permet de définir la fréquence des paiements pour un type d’intervalle donné. Si la fréquence choisie est de 1, les paiements auront lieu une fois par jour/semaine/mois/fin de mois. Si vous augmentez la fréquence, le calendrier « sautera » des intervalles. Donc, une fréquence de 2 signifie que les paiements auront lieu tous les deux jours/semaines/mois/fins de mois.
“billingIntervalCount”
Ce champ permet de définir le nombre de paiements au sein d’une même série.
Si vous incluez un montant ponctuel (oneTimeAmount) dans le corps de la demande, cette transaction supplémentaire ne fera pas partie du calcul des intervalles de la série de paiements.
Les abonnements reposent sur un mode de paiement qui est utilisé par les systèmes de Moneris pour tous les paiements d’une même série. L’objet “paymentMethod” comprend un schéma unique selon le mode de paiement choisi pour un calendrier des paiements. Quel que soit le mode de paiement utilisé, vous devez inclure l’objet “credentialOnFileInformation”. La valeur FIRST (premier) doit être utilisée dans le champ “paymentInformation” et la valeur RECURRING (périodique) doit être utilisée dans le champ “paymentIndicator”.
5. Identifiants au dossier pour les abonnements
Pour les transactions subséquentes, gérées par Moneris, l’objet “credentialOnFileInformation” sera ajusté en votre nom, au besoin. La valeur SUBSEQUENT (subséquent) pourra être utilisée dans le champ “paymentInformation”.
Trouvez votre code de réponse et découvrez ce qu’il signifie.
Moneris renverra une réponse à votre serveur avec les données concernant le succès ou l’échec de la demande. Le code d’état de la réponse HTTP et le contenu de l’objet “transactionDetails”, dans le corps de la réponse, vous informeront du résultat des transactions. Notez que si le paiement unique initial est refusé ou si le processus de validation de la carte échoue, vous recevrez un message d’erreur pour toute la série de paiements périodiques.
6. Points d’ancrage Web pour les abonnements
Lorsqu’un paiement est effectué avec succès dans le cadre d’un abonnement, Moneris envoie les détails de la transaction à votre serveur. Le message est envoyé au moyen d’un appel POST à l’URL de rappel (“callbackUrl”) précisé dans votre demande de création d’abonnement.
Exemples
Renseignements Supplémentaires
Définitions de l’API
Consultez les endpoints (points de terminaison), les formats des demandes et des réponses, ainsi que les modes d’authentification de ce scénario.
.svg)