• France
état des services
démonstrations
assistance
FAQContacter le support
Video tutorials
Rechercher
Catégories
Tags
France
France
Espagne
Europe (Anglais)
Inde
Accueil
Cas d'usage
Créer un paiement
Créer un paiement en plusieurs fois
Proposer un paiement complémentaire
Créer un paiement par alias (token)
Créer un lien de paiement
Créer un abonnement
Gérer vos abonnements
Gérer vos transactions (rembourser,...)
Analyser vos journaux
Docs API
Formulaire embarqué
API REST
Formulaire en redirection
SDK Mobile
Échange de fichiers
Mandats SEPA par API REST
Exemples de code
Moyens de paiement
Modules de paiement
Marketplace
Guides
Back Office Marchand
Back Office Expert
Guides fonctionnels

Intégration de la tokénisation réseau (PSP)

La tokénisation réseau est une obligation réglementaire imposée par le réseau de la carte : Mastercard, Visa.

Ces Web services sont réservés aux PSP (Prestataire de service de paiement).

La tokénisation réseau correspond à la création d'un token réseau par le réseau de la carte (Mastercard, Visa).

Liste

Description Web Service
Créer un token réseau auprès du réseau PCI/NetworkToken/Create
Récupérer certaines informations sur un token réseau PCI/NetworkToken/Checkout
Résilier un token réseau PCI/NetworkToken/Delete
Récupérer toutes les informations sur un token réseau PCI/NetworkToken/Refresh

Prérequis

A ce jour, ce service est uniquement proposé :

  • par Visa et Mastercard
  • pour le paiement par cartes

La tokénisation réseau ne fonctionne pas pour le réseau CB.

Création du token réseau

Recommandations

  • Effectuer la tokénisation réseau après un paiement réussi.
  • Gérer les codes erreurs en cas d'échec (carte non enrôlée, carte non éligible, ...) de la tokénisation réseau.

Testez le Web Service PCI/NetworkToken/Create depuis notre playground: PCI/NetworkToken/Create.

Requête

Exemple de requête
Champs obligatoires :
  • Réseau: "VISA".
  • PAN : "4970100000000055".
  • expiryMonth : "11".
  • expiryYear : "24".
  • E-mail de l'acheteur : "sample@example.com".
/fr/rest/V4.0/api/kb/authentication.html
https://api.lyra.com/api-payment/V4/PCI/NetworkToken/Create
    {
      "customer": {
        "email": "sample@example.com"
      },
      "paymentForm": {
        "network": "VISA",
        "pan": "4970100000000055",
        "expiryMonth": 11,
        "expiryYear": 24,
        "securityCode": "123"
      }
    }

Retrouvez l'intégralité et la description des champs dans notre playground : PCI/NetworkToken/Create

Réponse

Exemple de réponse 
      {
        "webService": "PCI/NetworkToken/Create",
        "version": "V4",
        "applicationVersion": "6.10.0",
        "status": "SUCCESS",
        "answer": {
            "networkTokenRequestorId": 11214880129,
            "networkTokenReference": "NDk3MDEwMDAjMDA1NSMxMTIwMjQjNDk5MDAwMTUwMDAwMDA2NCMxMTIwMjQ=",
            "networkTokenData": {
                "lastFour": "0064",
                "expiryMonth": "11",
                "expiryYear": "2024",
                "_type": "V4/NetworkToken/NetworkTokenData"
            },
            "_type": "V4/NetworkTokenCreateResponse"
        },
        (...)
        "_type": "V4/WebService/Response"
    }

Dans cet exemple, la référence du token réseau, champ networkTokenReference correspond à : NDk3MDEwMDAjMDA1NSMxMTIwMjQjNDk5MDAwMTUwMDAwMDA2NCMxMTIwMjQ=.

Retrouvez l'intégralité et la description des champs dans notre playground : answer/NetworkTokenCreate

Paiement avec un token réseau

Paiement en un clic
Ce mode facilite le paiement pour l'acheteur. Il n'a pas besoin de ressaisir le numéro de la carte bancaire pour payer.

Requête

Exemple de requête

Utilisez le Web Service PCI/NetworkToken/Checkout pour obtenir le networkTokenCryptogram.

Transmettez **cette donnée obligatoire** lors de la demande d'autorisation.

Champs obligatoires :

* Réseau : "VISA". * Référence du token réseau : "NDk3MDEwMDAjMDA1NSMxMTIwMjQjNDk5MDAwMTUwMDAwMDA2NCMxMTIwMjQ=". * Montant: 1200. * Devise : "EUR". * Référence de la commande : "OrderId 123".
/fr/rest/V4.0/api/kb/authentication.html
https://api.lyra.com/api-payment/V4/PCI/NetworkToken/Checkout
    {
      "network": "VISA",
      "networkTokenReference": "NDk3MDEwMDAjMDA1NSMxMTIwMjQjNDk5MDAwMTUwMDAwMDA2NCMxMTIwMjQ=",
      "amount": 1200,
      "currency": "EUR",
      "orderId": "OrderId 123"
  }

Réponse

Exemple de réponse 
      {
        "webService": "PCI/NetworkToken/Checkout",
        "version": "V4",
        "applicationVersion": "6.10.0",
        "status": "SUCCESS",
        "answer": {
            "networkTokenRequestorId": 70784110579,
            "networkTokenReference": "NDk3MDEwMDAjMDA1NSMxMTIwMjQjNDk5MDAwMTUwMDAwMDA2NCMxMTIwMjQ==",
            "networkToken": "4990001500000031",
            "networkTokenCryptogram": "e881de864f0c4c7e8aee19316a==",
            "networkTokenData": {
                "lastFour": "0031",
                "expiryMonth": "11",
                "expiryYear": "2023",
                "_type": "V4/NetworkToken/NetworkTokenData"
            },
            "cardData": {
                "lastFour": "0055",
                "expiryMonth": "11",
                "expiryYear": "2023",
                "_type": "V4/NetworkToken/NetworkTokenData"
            },
            "_type": "V4/NetworkTokenGetResponse"
        },
        (...)
        "_type": "V4/WebService/Response"
    }

Lors de la demande d'autorisation, transmettez les données suivantes :

* champ networkTokenRequestorId. Ex : "70784110579". * champ networkToken. Ex : "4990001500000031". * champ networkTokenCryptogram. Ex : "e881de864f0c4c7e8aee19316a=="

avec les données sur l'expiration du token réseau :

* champ networkTokenData.expiryMonth. Ex : "11". * champ networkTokenData.expiryYear. Ex : "2023".

Retrouvez l'intégralité et la description des champs dans notre playground : answer/NetworkTokenGet


Paiement 0 clic
Ce mode permet de payer sans affichage du formulaire de paiement et sans authentification (appel de serveur à serveur).

Sans authentification, les transactions ne sont pas protégées contre les risques de fraude et plus spécifiquement en cas de contestation du porteur de carte.

Lors de la première échéance, utilisez le Web Service PCI/NetworkToken/Checkout pour obtenir le champ networkToken.

Enregistrez-le pour le transmettre lors des prochaines échéances.

Lors de la demande d'autorisation, transmettez les données suivantes :

  • champ networkTokenRequestorId. Ex : "70784110579".
  • champ networkToken. Ex : "4990001500000031".

avec les données sur l'expiration du token réseau :

  • champ networkTokenData.expiryMonth. Ex : "11".
  • champ networkTokenData.expiryYear. Ex : "2023".

À la différence du paiement en 1 clic (interaction avec l'acheteur), le champ networkTokenCryptogram n'est pas requis.

Gestion du token réseau

Mettre à jour un token réseau

Requête

Exemple de requête
Utilisez le Web Service PCI/NetworkToken/Refresh pour actualiser les données du **token réseau**.

Champs obligatoires :

  • Réseau : "VISA".
  • Référence du token réseau : "NDk3MDEwMDAjMDA1NSMxMTIwMjQjNDk5MDAwMTUwMDAwMDA2NCMxMTIwMjQ="
/fr/rest/V4.0/api/kb/authentication.html
https://api.lyra.com/api-payment/V4/PCI/NetworkToken/Refresh
    {
      "network": "VISA",
      "networkTokenReference": "NDk3MDEwMDAjMDA1NSMxMTIwMjQjNDk5MDAwMTUwMDAwMDA2NCMxMTIwMjQ="
  }

Réponse

Exemple de réponse 
    {
      "webService": "PCI/NetworkToken/Refresh",
      "version": "V4",
      "applicationVersion": "6.10.0",
      "status": "SUCCESS",
      "answer": {
          "networkTokenReference": "NDk3MDEwMDAjMDA1NSMxMTIwMjQjNDk5MDAwMTUwMDAwMDA2NCMxMTIwMjQ=",
          "networkTokenStatus": "ACTIVE",
          "networkTokenData": null,
          "cardData": {
              "lastFour": "0055",
              "expiryMonth": "11",
              "expiryYear": "2023",
              "_type": "V4/NetworkToken/NetworkTokenData"
          },
          "_type": "V4/NetworkTokenRefreshResponse"
      },
      "ticket": "350aa99f60f14daf868182a84e0ed6ed",
      "serverDate": "2023-11-29T15:46:52+00:00",
      (...)
      "_type": "V4/WebService/Response"
  }

Retrouvez l'intégralité et la description des champs dans notre playground : answer/NetworkTokenRefresh

Analyse de la réponse NetworkTokenRefresh

Valeur des champs Description Action
Le champ networkTokenStatus a pour valeur SUSPENDED Carte suspendue Contactez le porteur de carte pour qu'il réactive ou change son moyen de paiement.
Le champ networkTokenStatus a pour valeur DELETED Compte clôturé Contactez le porteur de carte pour qu'il saisisse un nouveau moyen de paiement.
Les champs cardData.lastFour, cardData.expiryMonth et cardData.expiryYear changent de valeur. Renouvellement carte Actualisez les informations de la carte et du token réseau, grâce au Web Service PCI/NetworkToken/Checkout avant les prochaines échéances.

Procédure pour actualiser les données du token réseau

  1. Contactez la plateforme de paiement pour demander l'activation de la notification ITN (= Instant Token Notification).

  2. Lors de la réception de cette notification, utilisez le Web Service PCI/NetworkToken/Refresh pour vérifier si les données de la carte ont changé. Par exemple, analysez le champ cardData.lastFour( 4 derniers chiffres du numéro de carte).

  3. En cas de changement, utilisez le Web Service PCI/NetworkToken/Checkout pour actualiser les données de la carte et du token réseau avant les prochaines échéances.

Résilier un token réseau
Utilisez le Web Service PCI/NetworkToken/Delete.

Requête

Exemple de requête

Champs obligatoires :

  • Réseau : "VISA".
  • Référence du token réseau : "NDk3MDEwMDAjMDA1NSMxMTIwMjQjNDk5MDAwMTUwMDAwMDA2NCMxMTIwMjQ="
/fr/rest/V4.0/api/kb/authentication.html
https://api.lyra.com/api-payment/V4/PCI/NetworkToken/Delete
    {
      "network": "VISA",
      "networkTokenReference": "NDk3MDEwMDAjMDA1NSMxMTIwMjQjNDk5MDAwMTUwMDAwMDA2NCMxMTIwMjQ="
  }

Réponse

Exemple de réponse 
      {
        "webService": "PCI/NetworkToken/Delete",
        "version": "V4",
        "applicationVersion": "6.10.0",
        "status": "SUCCESS",
        "answer": {
            "status": "SUCCESS",
            "_type": "V4/NetworkTokenDeleteResponse"
        },
        "ticket": "9a6ca56e47d44eddb3a40efb00013f47",
        (...)
        "_type": "V4/WebService/Response"
    }
Nous recrutons
Mentions légales
Charte de Protection des Données Personnelles
25.18-1.11