- Directives d'intégration
- Fonctionnalités prises en charge (options de paiement)
- Échéanciers de paiement
- Paylater Installments
Paylater Installments
Paylater Installments permet aux payeurs de payer leurs achats et de verser des mensualités jusqu'au paiement du montant intégral.
Paylater Installments comprend :
- Offres génériques : échéanciers de paiement que vous souhaitez proposer et qui ne sont pas spécifiques aux articles, aux produits ou au panier.
- Offres sur articles : échéanciers de paiement que vous souhaitez proposer pour un article ou un produit spécifique.
- Offres sur panier : échéanciers de paiement que vous souhaitez proposer pour un panier avec un ou plusieurs articles ou produits.
Les conditions des échéanciers de paiement Paylater Installments peuvent contenir ce qui suit :
- Période de report pendant laquelle un payeur peut choisir de reporter son premier paiement.
- Composant de taux d'intérêt ou échéanciers de paiement sans intérêt provenant de la banque émettrice.
- Récompenses en espèces pour le choix de certains échéanciers de paiement.
Étapes d'intégration
| Nom de l'échéancier | Identifiant de l'échéancier | Description | API à utiliser |
|---|---|---|---|
1 |
Le payeur visite votre site Web |
Vous souhaitez savoir si des offres d'échéanciers de paiement génériques peuvent être présentées. |
Shopping Options Inquiry (Demande d'options d'achat) Vous devez soumettre une demande La réponse contient une liste d'offres d'échéanciers de paiement pour le commerçant. |
2 |
Le payeur consulte une catégorie ou effectue une recherche de produit |
Vous souhaitez afficher les offres d'échéanciers de paiement disponibles pour chaque article de la liste. |
Item Payment Plan Offers (Offres d'échéanciers de paiement pour les articles) Vous devez soumettre une demande La réponse contient une liste d'offres d'échéanciers de paiement pour l'article. |
3 |
Le payeur consulte la page d'informations détaillées d'un produit |
Vous souhaitez afficher les offres d'échéanciers de paiement pour cet article. |
Item Payment Plan Offers (Offres d'échéanciers de paiement pour les articles) Vous devez soumettre une demande WS API ITEM_PAYMENT_PLAN_OFFERS pour vous renseigner sur les offres d'échéanciers de paiement pour un seul article (c'est-à-dire que la liste ne contient qu'un seul article). La réponse contient une liste d'offres d'échéanciers de paiement pour l'article. |
4 |
Le payeur consulte le panier et indique qu'il souhaite payer sur la page de paiement. |
Vous souhaitez afficher
|
Options de paiement, dont les produits d'échéanciers de paiement Vous devez soumettre une demande WS API PAYMENT_OPTIONS_INQUIRY pour vous renseigner sur
La réponse contient un produit d'échéancier de paiement comme « Paylater Installments ». |
5 |
Le payeur a sélectionné le produit d'échéancier de paiement comme « Paylater Installments » |
Vous souhaitez afficher toutes les offres d'échéanciers de paiement pour ce produit d'échéancier de paiement. |
Options de paiement, dont les produits d'échéanciers de paiement Vous devez soumettre une demande WS API PAYMENT_OPTIONS_INQUIRY pour vous renseigner sur l'offre d'échéancier de paiement disponible pour ce produit d'échéancier de paiement. La réponse contient une liste d'offres d'échéanciers de paiement pour le panier ou la commande, et le produit d'échéancier de paiement. |
6 |
Le payeur a fourni le BIN de la carte (lors de la saisie du numéro de la carte) |
En fonction du BIN de la carte que vous souhaitez afficher
|
Options de paiement, dont les offres d'échéanciers de paiement pour le panier ou la commande Vous devez soumettre une demande WS API PAYMENT_OPTIONS_INQUIRY pour vous renseigner sur
La réponse contient une liste d'offres d'échéanciers de paiement pour le panier ou la commande, et le BIN. |
7 |
Le payeur accepte l'offre d'échéancier de paiement du panier et accepte les conditions générales |
Vous souhaitez soumettre l'acceptation de l'offre par le payeur. |
Si le payeur sélectionne l'une des offres de ce mode de paiement comme « Paylater Installments », vous devez fournir les conditions générales renvoyées dans la réponse PAYMENT_OPTIONS_INQUIRY pour les offres du panier et le payeur doit accepter l'offre pour continuer avec cet échéancier de paiement. Accepter l'offre Vous affichez les conditions générales (dont les détails sont fournis dans la réponse PAYMENT_OPTIONS_INQUIRY) au payeur. Le payeur accepte les conditions générales.
Vous soumettez ensuite une demande UPDATE_PAYMENT_PLAN_OFFER. La demande doit comporter
La réponse indique si vous pouvez procéder à la commande, avec cette offre. Si
|
8 |
Le payeur procède au paiement |
- |
Demande Authorize ou Pay Le commerçant soumet une demande WS API AUTHORIZE ou PAY avec l'identifiant d'offre d'échéancier de l'offre acceptée. L'offre d'échéancier de paiement du panier que le payeur a accepté devient à présent l'échéancier de paiement pour la commande ou la transaction. |
Référence de l'API Payment Options Inquiry (Demande d'options de paiement) [REST][NVP]
Shopping Options Inquiry (Demande d'options d'achat)
Vous pouvez demander à la passerelle une liste d'offres d'échéanciers génériques valides à l'aide de l'opération Shopping Options Inquiry (Demande d'options d'achat). Les détails suivants sur les échéanciers de paiement pris en charge sont retournés :
À partir de la version 70, la réponse contient les produits d'échéanciers de paiement pris en charge, à savoir « Paylater Installments » :
paymentPlanProduct.{paymentPlanProductId}paymentPlanProduct.{paymentPlanProductId}.namepaymentPlanProduct.{paymentPlanProductId}.logoUrl
Chaque offre d'échéancier de paiement dispose d'un identifiant d'offre unique et de l'identifiant du produit d'échéancier de paiement correspondant :
paymentPlanOffer.{id}paymentPlanOffer.{id}.currency (populated with payerCurrency from request)paymentPlanOffer{id}.paymentPlanProductIdpaymentPlanOffer{id}.totalAmountpaymentPlanOffer{id}.numberOfPaymentspaymentPlanOffer{id}.subsequentPaymentAmountpaymentPlanOffer{id}.firstPaymentAmountpaymentPlanOffer{id}.deferalPeriodpaymentPlanOffer{id}.interest.ratepaymentPlanOffer{id}.interest.discountAmountpaymentPlanOffer{id}.feeAmountpaymentPlanOffer{id}.cashAward.amountpaymentPlanOffer{id}.cashAward.payerInstructionTextpaymentPlanOffer{id}.qualifier.descriptionpaymentPlanOffer{id}.qualifier.logoUrlpaymentPlanOffer{id}.minimumAmountpaymentPlanOffer{id}.maximumAmountItem Payment Plan Offers (Offres d'échéanciers de paiement pour les articles)
Vous pouvez demander à la passerelle une liste d'offres d'échéanciers valides pour un article spécifique à l'aide de l'opération Item Payment Plan Offers (Offres d'échéanciers de paiement pour les articles).
La demande contient les détails suivants :
merchantpayerlocalecurrencyitem[0].skuitem[0].unitPriceitem[1].skuitem[1].unitPriceLes détails suivants sur les échéanciers de paiement pris en charge sont retournés. À partir de la version 70, la réponse contient les produits d'échéanciers de paiement pris en charge, à savoir « Paylater Installments » :
paymentPlanProduct.{paymentPlanProductId}paymentPlanProduct.{paymentPlanProductId}.namepaymentPlanProduct.{paymentPlanProductId}.logoUrl
Chaque offre d'échéancier de paiement dispose d'un identifiant d'offre unique et de l'identifiant du produit d'échéancier de paiement correspondant :
item[n].paymentPlanOffer.{id}item[n].paymentPlanOffer.{id}.paymentPlanProductIditem[n].paymentPlanOffer.{id}.currencyitem[n].paymentPlanOffer.{id}.totalAmountitem[n].paymentPlanOffer.{id}.numberOfPaymentsitem[n].paymentPlanOffer.{id}.deferalPerioditem[n].paymentPlanOffer.{id}.subsequentPaymentAmountitem[n].paymentPlanOffer{id}.firstPaymentAmountitem[n].paymentPlanOffer{id}.interest.rateitem[n].paymentPlanOffer{id}.interest.discountAmountitem[n].paymentPlanOffer{id}.feeAmountitem[n].paymentPlanOffer{id}.cashAward.amountitem[n].paymentPlanOffer{id}.cashAward.payerInstructionTextitem[n].paymentPlanOffer{id}.qualifier.descriptionitem[n].paymentPlanOffer{id}.qualifier.logoUrlresult
Payment Plan Inquiry (Demande d'échéancier de paiement)
Vous pouvez demander à la passerelle une liste de produits d'échéanciers de paiement et d'offres d'échéanciers valides à l'aide de l'opération Payment Options Inquiry (Demande d'options de paiement).
La demande contient :
payerLocaleorder.amountorder.currencyorder.item[n].skuorder.item[n].quantityorder.item[n].unitPriceorder.itemAmountsourceOfFunds.provided.card.prefix
À partir de la version 70, la réponse contient les produits d'échéanciers de paiement pris en charge, à savoir « Paylater Installments » :
paymentPlanProduct.{paymentPlanProductId}paymentPlanProduct.{paymentPlanProductId}.namepaymentPlanProduct.{paymentPlanProductId}.logoUrlChaque offre d'échéancier de paiement dispose d'un identifiant d'offre unique et de l'identifiant du produit d'échéancier de paiement correspondant :
paymentTypes.card.paymentPlanOffer.{id}paymentTypes.card.paymentPlanOffer.{id}.paymentPlanProductIdpaymentTypes.card.paymentPlanOffer.{id}.numberofPaymentspaymentTypes.card.paymentPlanOffer.{id}.deferralPeriodpaymentTypes.card.paymentPlanOffer.{id}.interest.chargedpaymentTypes.card.paymentPlanOffer.{id}.currencypaymentTypes.card.paymentPlanOffer.{id}.minimumOrderAmountpaymentTypes.card.paymentPlanOffer.{id}.startDatepaymentTypes.card.paymentPlanOffer.{id}.endDatepaymentTypes.card.paymentPlanOffer.{id}.totalAmountpaymentTypes.card.paymentPlanOffer.{id}.firstPaymentAmountpaymentTypes.card.paymentPlanOffer.{id}.subsequentPaymentAmountpaymentTypes.card.paymentPlanOffer.{id}.feeAmountpaymentTypes.card.paymentPlanOffer.{id}.interest.ratepaymentTypes.card.paymentPlanOffer.{id}.interest.discountAmountpaymentTypes.card.paymentPlanOffer.{id}.termsAndConditions.textpaymentTypes.card.paymentPlanOffer.{id}.termsAndConditions.acceptanceRequiredpaymentTypes.card.paymentPlanOffer.{id}.termsAndConditions.acceptanceTextpaymentTypes.card.paymentPlanOffer.{id}.cashAward.amountpaymentTypes.card.paymentPlanOffer.{id}.cashAward.payerInstructionTextpaymentTypes.card.paymentPlanOffer.{id}.qualifier.textpaymentTypes.card.paymentPlanOffer.{id}.qualifier.logoUrl
Update Payment Plan Offers (Mettre à jour les offres d'échéanciers de paiement)
Vous pouvez soumettre l'acceptation des offres d'échéanciers de paiement par le payeur au fournisseur à l'aide de l'opération Update Payment Plan Offers (Mettre à jour les offres d'échéanciers de paiement).
- La demande contient :
sourceOfFunds parameter grouporder.amountorder.currencyorder.item[n].quantityorder.item[n].unitPrice
Vous pouvez fournir les détails de l'acceptation du payeur en indiquant :
paymentPlanOffer.payerAcceptance = truepaymentPlanOffer.termsAndConditionsDisplayLa valeur peut être l'une des suivantes :
NONE- vous n'avez pas affiché le texte des conditions générales.TERMS_AND_CONDITIONS_ONLY- vous avez affiché le texte des conditions générales.TERMS_AND_CONDITIONS_AND_ACCEPTANCE- vous avez affiché le texte des conditions générales et demandé au payeur d'accepter les conditions générales.
Soumettre une transaction avec l'échéancier de paiement
Pour soumettre une transaction avec l'échéancier de paiement sélectionné par le payeur, fournissez les champs suivants dans une demande Authorize/Pay (Autoriser/Payer) ou Update Session (Mettre à jour la session). A compter de la version 70, renseignez le champ paymentPlan.offerID avec l'ID de l'offre dans la réponse Payment Options Inquiry (Demande d'options de paiement).
La passerelle traite un échéancier de paiement uniquement si les conditions suivantes sont satisfaites :
- La devise de la commande est prise en charge sur l'échéancier de paiement.
- Le montant de la commande est supérieur au montant minimum de la commande défini sur l'échéancier de paiement.
- Le type de carte est pris en charge sur l'échéancier de paiement.