Segmentation en unités réseau
- Value Added Service
- Europe & UK
Aperçu
Le service de segmentation en unités réseau permet à Paysafe de demander des jetons de paiement à Visa Token Service (VTS) et à Mastercard Secure Card on File (SCoF) pour le compte du marchand. Ces jetons remplacent le numéro de compte principal (NCP) d’une carte de débit ou de crédit, garantissant ainsi un traitement sécurisé des transactions. Chaque jeton de réseau est émis par des systèmes de cartes, ressemblant visuellement à un NCP de carte normal avec le même nombre de chiffres. Cependant, ces jetons ajoutent une couche de sécurité supplémentaire.
En tant que demandeur de jetons de réseau agréé pour ce service, vous aurez la possibilité d’effectuer des paiements, des remboursements, des crédits initiaux et des crédits autonomes à l’initiative du client ou du marchand en Europe à l’aide de jetons de réseau. Cette mesure remplace l’utilisation des numéros de compte principal de carte qui sont sous-jacents au jeton permanent de Paysafe. Ce service sera offert en Amérique du Nord à compter d’octobre 2023.
Vous pouvez accéder au service par l’intermédiaire du Coffre-fort client, de l’API Carte et de l’API Paiements. En outre, il est offert via nos solutions hébergées : Paysafe.JS, Paysafe Checkout v1 et Paysafe Checkout v2.
Les jetons de réseau ont trois états : actif, suspendu et supprimé. Les transactions ne peuvent être traitées qu’avec des jetons actifs. Les transactions effectuées avec des cartes suspendues dotées de jetons de réseau échoueront dans notre système avec l’erreur 5500, sans atteindre les banques émettrices ni affecter le taux d’acceptation des cartes. Les cartes suspendues avec des jetons de réseau seront grisées dans Paysafe Checkout v1 et Paysafe Checkout v2 en novembre 2023. Si vous êtes intégré au Paysafe.JS ou directement à nos API, nous vous recommandons de griser les cartes suspendues avec des jetons de réseau sur votre page de paiement en votre nom. À un moment donné, les clients ou les banques émettrices peuvent reprendre l’activité des jetons de réseau suspendus, ce qui peut se refléter sur le serveur frontal. Les jetons de réseau peuvent être supprimés par les systèmes de cartes, par les marchands ou par Paysafe.
Si vous souhaitez vous retirer du service, vous avez la possibilité de le faire à tout moment.
Avantages
- Un niveau de sécurité supplémentaire pour les transactions effectuées avec des cartes de débit et de crédit
- Augmentation du taux d’acceptation des cartes
- Amélioration de l’interface utilisateur pour les clients ayant des cartes enregistrées
- Intégration supplémentaire mineure pour les marchands qui traitent les cartes avec Paysafe
Marques de cartes
- Visa
- Mastercard
Disponibilité du produit
- Coffre-fort client + API Cartes
- API Paiements
- Paysafe.JS (propulsé par Coffre-fort client + API Cartes)
- Paysafe.JS (propulsé par l’API Paiements)
- Paysafe Checkout v1
- Paysafe Checkout v2
Exigences de configuration
Pour créer un compte de test dans les environnements de bac à sable et de production, Paysafe a besoin de votre consentement aux conditions générales & Accord sur les conditions d’utilisation du service.
La page de paiement de votre site Web ou de votre application mobile doit pouvoir prendre en charge les cartes enregistrées par l’utilisateur.
Pour la segmentation en unités réseau lors de l’enregistrement d’une carte ou de la création d’un profil, le Coffre-fort client et l’API Paiements répondent aux exigences suivantes :
- accountId
- adresse courriel
Remarque : Le paramètre accountId doit être placé dans l’objet carte lors des appels API au Coffre-fort client pour l’enregistrement de la carte au dossier. Cette démarche aboutira à la création d’un jeton de réseau et d’un jeton de carte permanent.
Types de transaction
- Autorisation
- Annulation d’autorisation
- Autorisation + règlement
- Règlement
- Autorisation récurrente
- Vérification
- Remboursement
- Crédit autonome
- Crédit initial
Diagramme de segmentation en unités réseau
Création de la segmentation en unités réseau
Traitement avec un jeton de réseau
Scénarios habituels
Création d’un jeton de réseau dans le Coffre-fort client
API à utiliser
Après avoir autorisé avec succès un paiement avec la carte comme mode de paiement, vous devez enregistrer la carte de débit ou de crédit utilisée dans un profil client existant ou créer un nouveau profil dans le Coffre-fort client. Lors de ce processus, ajoutez l’identifiant de compte marchand dans l’objet carte et placez l’adresse électronique du client à l’extérieur de l’objet carte, comme le montre l’exemple ci-dessous. En suivant cette procédure, le service de segmentation en unités réseau sera activé, invitant le réseau de cartes concerné à générer un jeton de réseau pour la carte fournie.
Exemple
{
"merchantCustomerId": "mycustomer1",
"dupCheck": false,
"locale": "en_GB",
"firstName":"John",
"lastName": "Doe",
"email": "accountholder1@example.com",
"card": {
"accountId": "1006385560",
"singleUseToken": "SCjaFaHN6Ud1y3ee"
}
}
Autorisation avec un jeton de réseau dans l’API Cartes
API à utiliser
Le jeton Paysafe permanent généré contient un jeton de réseau unique, qui est sous-jacent avec le NCP. Le jeton permanent Paysafe doit être envoyé dans le corps de la requête pour autorisation, mais la transaction sera traitée avec le jeton de réseau sous-jacent et un cryptogramme à usage unique, émis par le système de cartes concerné.
Création d’un jeton de réseau dans l’API Paiements
API à utiliser
Le jeton de réseau est créé lors de la création du client. La différence avec l’approche adoptée dans le Coffre-fort client est que l’identifiant de compte n’est pas transmis à l’intérieur de l’objet carte dans le corps de la demande d’enregistrement d’une carte dans un fichier et que l’objet carte n’est pas du tout présent. Lorsque la carte est enregistrée dans le fichier, un payment handle à usage multiple Paysafe est créé.
Exemple
{
"merchantCustomerId": "mycustomer2",
"locale": "en_US",
"paymentHandleTokenFrom": "SC1IHQO94g1ieppo",
"accountId": "1006385561",
"email": "accountholder2@example.com"
}
Autorisation avec un jeton de réseau dans l’API Paiements
API à utiliser
Pour les transactions initiées par le marchand dans l’API Paiements, vous pouvez transmettre directement payment handle à usage multiple de la carte. Un jeton de réseau se trouve sous ce payment handle à usage multiple et la transaction sera traitée avec ce jeton au lieu du véritable NCP.
Payment Handle à usage unique pour le jeton de réseau
Pour créer un payment handle à usage unique pour une transaction initiée par un client avec une carte enregistrée, vous devez d’abord créer un jeton client à usage unique.
API à utiliser
Par la suite, le Payment Handle à usage unique peut être créé pour une transaction initiée par le client à l’aide d’une carte enregistrée dans l’API Paiements, Paysafe.JS et Paysafe Checkout v2.
API à utiliser
Le Payment Handle à usage unique nouvellement créé doit être utilisé pour l’autorisation de la transaction initiée par le client. Pour de plus amples renseignements sur les transactions initiées par le client avec un jeton/un payment handle à usage unique, veuillez consulter la documentation relative aux cartes enregistrées dans Paysafe.JS et Paysafe Checkout.
Effectuer des tests dans le bac à sable
Visa nettoie automatiquement les jetons du réseau bac à sable toutes les heures. Cette action entraîne la suppression immédiate des jetons permanents du bac à sable de Paysafe. Utilisez les cartes de test suivantes, dont le CVV et la date d’expiration sont exacts.
| Réseau de cartes | Numéro de carte | CVV | Date d’expiration |
|---|---|---|---|
| Visa | 4895379980026288 | 343 | 12/2025 |
| Visa | 4895379980026387 | 219 | 12/2025 |
| Visa | 4895379980026486 | 234 | 12/2025 |
| Visa | 4895379980026585 | 048 | 12/2025 |
| Mastercard | 2222690420064590 | 3 chiffres au choix | Toute date ultérieure |
| Mastercard | 2222690420064574 | 3 chiffres au choix | Toute date ultérieure |
| Mastercard | 2222690420064582 | 3 chiffres au choix | Toute date ultérieure |
| Mastercard | 5120350100064594 | 3 chiffres au choix | Toute date ultérieure |
| Mastercard | 2223520127577835 | 3 chiffres au choix | Toute date ultérieure |