Comment configurer votre compte ?

Vous devez avoir l'option "Tokenisation par les schemes" : veuillez pour rapprocher de l'équipe support Payline pour mettre à jour votre abonnement.

Consulter la configuration sur le centre administration de Monext Online : Configuration de la tokenisation.

Pour activer un service de tokenisation de Scheme, vous devez saisir un CLIENT APP ID puis demander l'activation à Visa ou Masrercard en cliquant sur Activer pour recevoir un TRID.

Comment intégrer en Mode page Web (widget) ?

Enrôlement d’une carte sans paiement

Ce service permet à un acheteur de demander l’enrôlement de sa carte dans son wallet ou créer un wallet s'il n'en existe pas.

Vous pouvez utiliser l'API Payline 

• en mode page web avec le service manageWebWalletRequest
• en mode direct avec le service createWalletRequest
  
  

Enrôlement d'une carte lors d'un paiement 

Le porteur souhaite enregistrer sa carte dans le wallet du commerçant lorsqu'il réalise un premier paiement.
Dans ce cas, le paiement est réalisé avec les données de la carte puis le wallet est crée pour de prochains achats.

Vous pouvez utiliser l'API Payline :

• en mode page web avec les fonctions du service doWebPayment 
• en mode direct avec les fonctions wallet du service doAuthorization
  
  

Paiement avec carte enrôlée

Ce cas d’utilisation correspond à la demande de paiement via une carte déjà enrôlée à Visa Token Service ou à Mastercard Digital Enablement Service.

Vous pouvez utiliser l'API Payline :

• en mode page web avec les fonctions du service doWebPayment 
• en mode direct avec les fonctions wallet du service doAuthorization

Pour les paiements récurrents et par abonnement, vous devez également utiliser les fonctions wallet avec les cartes tokenisées.

Mise à jour des infos cartes depuis Payline

Ce cas d’utilisation correspond à une demande de suppression et mise a jour de la carte dans le wallet.
Cette demande est retransmise via Payline au Token Requestor sous la forme d'une suspension ou de mise à jour de la carte dans le wallet.

Vous pouvez désactiver un portefeuille et son token, simplement en désactivant le portefeuille : voir Centre Administration - Paiement par portefeuille

Comment intégrer en Mode Direct ?

Pour réaliser un paiement avec token par réseaux avec Monext, le commerçant doit se connecter aux réseaux pour les tokenizer.

1. Prérequis : abonnement et configuration "Token par scheme" dans le centre administration.
   1. Enrôllement du commerçant auprès de Visa et/ou Mastercard.
   2. Réception du TRID.
      
      
2. Le commerçant réalise une demande d'autorisation avec la token avec le service doAuthorization selon le cas ci desssous.
   

• • Pour une opération à l'initiation de l'acheteur (CIT) :
    • Indiquer en plus des informations ci dessous le cryptogramme dans card.tokenRequestorCryptogram
      
      
  • Pour une opération à l'initiation du commerçant (MIT) :
    • Indiquer des informations supplémentaire dans l'object card dessous.

Les web services

L'ensemble des services suivants doivent fonctionner avec un token :

• doAuthorization avec les informations supplémentaires dans l'object card lors d'une demande d'autorisation avec un token réseaux:

• verifyEnrollment
• doCapture
• doRefund
• doCredit
• DoReset

Choix de la marque

Les token par scheme Visa ou Mastercard, le commerçant doit :

1. Indiquer la marque du token lors d'un appel à Monext via le champ payment.cardBrand
   Si la marque n'est pas passée par le commerçant, alors la logique habituelle de routage est appliquée : routage sur la marque par défaut sélectionnée dans le contrat du commerçant.
   
   
2. Le commerçant doit indiquer le réseau de la carte.

Le choix de la marque sera celui du token.

Centre administration

Portefeuille : vous pouvez consulter la carte mise à jour dans un portefeuille dès qu'elle est tokenisée.

Transaction : vous pouvez retrouver les informations dans le détail de la transaction, le token et l'indicateur "Type de PAN = Scheme PAN" dans le bloc carte :

Comment réaliser des tests ?

Les cartes éligible pour la tokenisation :

• en mode direct : voir les cartes de test.

Les codes de retour

Monext Online vous informe du résultat d’un paiement via le ShortMessage, selon le mode d'intégration proposé par le moyen de paiement. 

• pour l'API WebPayment avec le service getWebPaymentDetails,
• pour l'API DirectPayment en réponse du service doAuthorization de manière synchrone ou getTransactionDetails en réponse asynchrone.

Les états retournés :

• Le paiement est accepté avec l'état ACCEPTED et le code retour 00000.
• Le paiement est refusé avec l'état REFUSED. Le code varie en fonction du motif de refus (Par exemple : 01xxx pour une raison bancaire ou 04xxx pour une suspicion de fraude).

La gestion des états et des codes retour sont listés ici.

Pages associées

• Page:
  Portefeuille électronique

Documentation Monext Online