worldline Direct
S'inscrire

Pour honorer les directives COF et pour demander à notre plateforme de traiter les transactions en conséquence, l'API Direct implémente un ensemble de propriétés. Chaque JSON dans notre collection représentant les cas d'utilisation contient les propriétés respectives et leur valeur correcte.

Propriété Description
cardPaymentMethodSpecificInput.tokenize

Indique que vous souhaitez tokeniser la carte utilisée dans cette transaction. Valeur fixe "true".

Pour chaque transaction réussie, notre plateforme renvoie un cardPaymentMethodSpecificInput.token
que vous pouvez utiliser pour les paiements ultérieurs CIT (exemple C). Assurez-vous de ne pas envoyer tokenize lors de l'utilisation du token.

cardPaymentMethodSpecificInput.isRecurring

Indique que ce paiement fait partie d'une série de paiements récurrents (exemple A). Vos clients vous ont autorisé à facturer des montants fixes (MITs) sur une base récurrente (c'est-à-dire pour des abonnements) en tant qu'instruction permanente (exemple E).

Valeur fixe "true".

cardPaymentMethodSpecificInput.recurring.
recurringPaymentSequenceIndicator

Indique que ce paiement est le premier d'une série de paiements récurrents (exemple A). Vos clients vous ont autorisé à facturer des montants fixes (MITs) sur une base récurrente (c'est-à-dire pour des abonnements) en tant qu'instruction permanente (exemple E).

Valeur fixe "first".

cardPaymentMethodSpecificInput.unscheduledCardOnFileRequestor

Indique le demandeur de cette transaction :

  • "cardholderInitiated" : Votre client initie cette transaction (exemples B/C). Cela marque également la transaction comme non programmée.
  • "merchantInitiated" : Vous initiez la transaction en votre nom. Réservé pour des cas d'utilisation avancés non décrits ici. Nous recommandons fortement de traiter les MITs via exemples D / E / F / G / H / J pour lesquels cette propriété est sans pertinence.
cardPaymentMethodSpecificInput.
unscheduledCardOnFileSequenceIndicator
Indique que ce paiement fait partie d'une série de paiements récurrents non programmés :
  • "first" : Le premier paiement de cette série (exemple B).
  • "subsequent" : Un paiement ultérieur de cette série (exemple C)
cardPaymentMethodSpecificInput.threeDSecure.
challengeIndicator

Gérez 3-D Secure pour les paiements initiaux/ultérieurs.

Indiquez le flux 3-D Secure préféré pour cette transaction.
Valeur fixe "challenge-required" pour garantir que 3-D Secure est activé lors de l'initiation d'une nouvelle série de paiements (exemples A/B).
Pour améliorer l'expérience de paiement de vos clients pour les CITs ultérieurs (exemple C), nous recommandons la valeur "no-challenge-requested". En savoir plus sur cette propriété et son utilisation dans notre guide dédié.

cardPaymentMethodSpecificInput.token

hostedCheckoutSpecificInput.tokens

Le(s) profil(s) de carte stocké(s) sur notre plateforme pour les paiements ultérieurs CIT (exemple C).

subsequentCardPaymentMethodSpecificInput.
subsequentType

Décrit l'utilisation équitable des données de carte pour les MITs sans token (exemples D à J). Selon le cas d'utilisation, différentes valeurs s'appliquent :

  • "Installment" : Pour des versements programmés sur une certaine période. Les montants et les intervalles sont fixes en tant qu'instruction permanente (exemple D).
  • "Recurring" : Pour des services récurrents (c'est-à-dire un abonnement) pour une période prolongée. Le montant est fixe en tant qu'instruction permanente (exemple E).
  • "Unscheduled" : Pour des services récurrents (c'est-à-dire pour des services payés à l'utilisation) pour une période prolongée. Les montants et les intervalles peuvent varier entre les paiements en tant qu'instruction permanente (exemple F).

Les valeurs suivantes décrivent les pratiques de l'industrie établies, vous permettant de traiter des transactions sans le consentement explicite de vos clients :

  • "Resubmission" : Vous avez déjà fourni les biens/services à votre client, mais vous n'avez pas pu collecter les fonds au moment de la commande (exemple G).
  • "PartialShipment" : Recueillez les fonds pour une commande partiellement payée. S'applique également à l'hôtellerie et à la location de voitures pour des séjours/locations prolongés (exemple H).
  • "DelayedCharge" : Appliquez des frais supplémentaires après la livraison des biens/services originaux (exemple I).
  • "NoShow" : Appliquez des frais de pénalité pour des biens/services réservés par vos clients mais non récupérés (par exemple, des chambres d'hôtel). S'applique également à des scénarios dans lesquels vos clients ont accepté un achat mais n'ont pas respecté les conditions de l'accord (exemple J).
{payment.id}

Le payment.id de la transaction précédente d'une série de paiements (exemples D à J).

Ajoutez-le comme paramètre de chemin à l'URL de l'API endpoint SubsequentPayment.

Cette page vous a-t-elle été utile ?

Avez-vous des commentaires ?

Merci pour votre réponse.
New Feature

Try out our new chatbot and find answers to all your questions.