- Directives d'intégration
- Fonctionnalités prises en charge (options de paiement)
- Échéanciers de paiement
- Échéanciers de paiement personnalisés
Échéanciers de paiement personnalisés
Les échéanciers de paiement personnalisés reposent sur un système d'instance-modèle, dans lequel vous pouvez créer des instances d'un modèle d'échéancier de paiement parmi 5 en spécifiant le nombre de versements et la période de report (le cas échéant).
- Payer par versements, sans intérêts
- Payer par versements après une période de report, avec intérêts
- Payer par versements, avec intérêts
- Payer intégralement après une période de report
- Payer par versements après une période de report, sans intérêts
Par exemple, vous pouvez créer les échéanciers de paiement suivants :
- Offre de fin d'exercice financier - pas d'intérêts, pas de paiement pendant six mois (instance du modèle 5)
- Paiement simplifié - paiement fixes pendant trois mois, sans intérêts (instance du modèle 1)
- Offre de Noël - achetez maintenant, payez la totalité dans six mois (instance du modèle 4)
Les échéanciers de paiement personnalisés sont actuellement proposés par :
- Banamex
- BBVA Bancomer
- First Data Brazil
- First Data Argentina
Payment Plan Inquiry (Demande d'échéancier de paiement)
Vous pouvez demander à la passerelle une liste des échéanciers valides pour une transaction à l'aide de l'opération Payment Options Inquiry (Demande d'options de paiement). Les détails suivants sur les échéanciers de paiement pris en charge sont retournés :
paymentTypes.card.paymentPlans[n].startDate: date de début de l'échéancier de paiement.paymentTypes.card.paymentPlans[n].endDate: date de fin de l'échéancier de paiement.paymentTypes.card.paymentPlans[n].numberOfPayments[n]: nombre de paiements échelonnés mensuels payables par le payeur (si cela s'applique au type d'échéancier).paymentTypes.card.paymentPlans[n].numberOfDeferrals[n]: nombre de mois maximum pendant lesquels le paiement peut être différé (si cela s'applique au type d'échéancier).paymentTypes.card.paymentPlans[n].minimumOrderAmounts[n].amount: montant minimum de la commande pour l'échéancier de paiement dans la devise prise en charge. Les échéanciers de paiement configurés ne seront proposés que si le montant total de la commande est supérieur ou égal à ce montant minimum de la commande.paymentTypes.card.paymentPlans[n].minimumOrderAmounts[n].currency: devise pour le montant minimum de la commande.paymentTypes.card.paymentPlans[n].payerInterest: indique si les intérêts de l'échéancier de paiement sont facturés au payeur.paymentTypes.card.paymentPlans[n].planId: identifiant unique généré par le système pour l'échéancier de paiement. L'identifiant de l'échéancier est unique pour tous les types d'échéanciers de paiement que vous pouvez avoir configurés.paymentTypes.card.paymentPlans[n].planName: identifiant fourni par le commerçant pour l'échéancier de paiement. Par exemple, Offre de fin d'exercice financier.paymentTypes.card.paymentPlans[n].planTemplate: modèle d'échéancier de paiement utilisé pour générer l'instance de l'échéancier de paiement. Par exemple, payer par versements, sans intérêts.
Généralement le nombre de versements ou de mois de report est limité à 99 maximum. Cependant, votre your payment service provider peut configurer la limite maximale pour chaque modèle dans le cadre de la configuration du commerçant.
À compter de la version 70, pour l'ID d'échéancier de paiement généré par le système, les offres d'échéancier de paiement disponibles sont retournées. Une liste d'échéanciers de paiement est retournée en fonction de la devise et du montant minimum de commande.
Chaque offre d'échéancier de paiement aura un ID d'offre unique :
paymentPlanProduct.{paymentPlanProductId}paymentPlanProduct.{paymentPlanProductId}.namepaymentPlanProduct.{paymentPlanProductId}.logoUrlpaymentTypes.card.paymentPlanOffer.{id}paymentTypes.card.paymentPlanOffer{id}.paymentPlanProductIdpaymentTypes.card.paymentPlanOffer.{id}.currencypaymentTypes.card.paymentPlanOffer.{id}.numberofPaymentspaymentTypes.card.paymentPlanOffer.{id}.subsequentPaymentAmountpaymentTypes.card.paymentPlanOffer.{id}.firstPaymentAmountpaymentTypes.card.paymentPlanOffer{id}.minimumOrderAmountpaymentTypes.card.paymentPlanOffer.{id}.deferralPeriodpaymentTypes.card.paymentPlanOffer.{id}.interest.chargedpaymentTypes.card.paymentPlanOffer.{id}.startDatepaymentTypes.card.paymentPlanOffer.{id}.endDatepaymentTypes.card.paymentPlanOffer.{id}.planTemplate
Référence de l'API Payment Options Inquiry (Demande d'options de paiement) [REST][NVP]
Demander un échéancier de paiement
Pour demander un échéancier de paiement pour une transaction, vous devez renseigner les champs suivants dans une demande Authorize/Pay (Autoriser/Payer) ou Update Session (Mettre à jour la session) :
paymentPlan.numberOfDeferralspaymentPlan.numberOfPaymentspaymentPlan.planId
La passerelle traite un échéancier de paiement uniquement si les conditions suivantes sont satisfaites :
- La date actuelle est postérieure ou identique à la date de début.
- La date actuelle est antérieure ou identique à la date de fin.
- Le montant de la commande est supérieur au montant minimum de la commande défini sur l'échéancier de paiement.
- La devise de la commande est prise en charge sur l'échéancier de paiement.
- Le type de carte est pris en charge sur l'échéancier de paiement.
À compter de la version 70, renseignez uniquement le champ paymentPlan.offerID dans la demande Authorize/Pay (Autoriser/Payer) or Update Session (Mettre à jour la session) avec l'ID d'offre fourni dans la réponse à la demande Payment Options Inquiry (Demande d'options de paiement).
Référence de l'API Payment Plans (Échéanciers de paiement) [REST][NVP]
Contraintes de l'échéancier de paiement
Vous pouvez limiter le nombre d'identifiants d'échéanciers de paiement et les mois de report/de paiements échelonnés pour une transaction donnée en utilisant les champs de contraintes de l'échéancier de paiement :
constraints.paymentPlans.numberOfDeferrals: nombre autorisé de mois de report pour l'échéancier de paiement.constraints.paymentPlans.numberOfPayments: nombre autorisé de paiements échelonnés pour l'échéancier de paiement.constraints.paymentPlans.supported[n]: fournit les identifiants pour les échéanciers de paiement pris en charge sur cette transaction. Si vous ne voulez pas proposer d'échéanciers de paiement, ne renseignez pas ces champs.
À compter de la version 70,
constraints.paymentPlans.deferralPeriod: nombre autorisé de mois de report pour l'échéancier de paiement.constraints.paymentPlans.numberOfPayments: nombre autorisé de paiements échelonnés pour l'échéancier de paiement.constraints.paymentPlans.supported[n]: fournit les identifiants pour les échéanciers de paiement pris en charge sur cette transaction. Si vous ne voulez pas proposer d'échéanciers de paiement, ne renseignez pas ces champs.
Référence de l'API Payment Plans Constraint (Contraintes des échéanciers de paiement) [REST][NVP]