Ce ne sont pas tous les commerçants qui arrivent chez ValPay qui ont un moyen de paiement tokenisé existant à migrer. Si un commerçant n'a jamais traité de paiements avec une solution tokenisée auparavant, il n'y a aucun jeton à échanger, le guide Processus de migration des jetons (tokens) vers Adyen ne s'applique donc pas.
Contrairement à la migration, ce processus ne nécessite pas l'intervention de ValPay. Les partenaires s'intègrent déjà directement à l'API Checkout d'Adyen à l'aide des identifiants fournis par ValPay (voir Intégration API et Tokenisation et paiements récurrents). Créer un tout nouveau jeton à partir d'une carte correspond à la même demande de tokenisation que celle décrite dans ces guides, sauf qu'elle est soumise avec un montant nul plutôt qu'un véritable débit.
1. Quand utiliser ce processus
Utilisez cette méthode dans les cas suivants :
Le commerçant n'a aucun jeton récurrent existant provenant d'un processeur précédent
Une carte est recueillie pour la première fois et doit être enregistrée pour la facturation récurrente future
Aucun paiement réel à plein montant ne doit être exécuté sur la carte uniquement pour générer le jeton
Si le commerçant a déjà un jeton provenant d'un processeur précédent, utilisez plutôt le guide Processus de migration des jetons (tokens) vers Adyen.
2. Comment ça fonctionne
Il s'agit du même processus que celui décrit dans Tokenisation et paiements récurrents, mais avec un montant fixé à zéro. Soumettez une demande /payments standard comprenant :
amount.value:0storePaymentMethod:trueshopperReference: votre identifiant unique pour le clientrecurringProcessingModel: par exempleUnscheduledCardOnFile
POST /v71/payments { "merchantAccount": "YOUR_MERCHANT_ACCOUNT", "amount": { "currency": "USD", "value": 0 }, "reference": "TOKENIZE-0001", "paymentMethod": { /* détails de la carte recueillis par Drop-in/Components */ }, "shopperReference": "SHOPPER-001", "storePaymentMethod": true, "recurringProcessingModel": "UnscheduledCardOnFile", "store": "YOUR_STORE_ID" }Une autorisation à valeur nulle réussie confirme que la carte est authentique et qu'elle peut être débitée. Adyen renvoie le jeton dans le webhook recurring.token.created, comme pour toute autre demande de tokenisation. Enregistrez ce jeton avec le shopperReference.
Les autorisations à valeur nulle sont prises en charge pour les cartes, Google Pay, PayPal, Apple Pay, Klarna et Amazon Pay. Elles ne sont pas prises en charge pour Alipay ni WeChat Pay; si un commerçant a besoin de tokeniser l'un de ces moyens de paiement, une autorisation à montant réel minimal est requise à la place.
3. Considérations relatives à la conformité PCI
La façon dont le numéro de carte est recueilli détermine la portée PCI, comme pour toute autre intégration :
Numéro de carte brut envoyé de serveur à serveur : exige que le partenaire soit entièrement conforme à la norme PCI DSS (SAQ D).
Numéro de carte recueilli au moyen d'un champ chiffré côté client (Drop-in/Components) : le numéro de carte est chiffré dans le navigateur avant d'atteindre un serveur, ce qui limite la portée PCI à SAQ A ou SAQ A-EP.
4. Configuration ponctuelle, pas une étape par demande
Si la tokenisation et le rôle d'autorisation à valeur nulle ne sont pas déjà activés sur le compte du partenaire, celui-ci devra communiquer une seule fois avec le soutien ValPay pour les faire activer, la même vérification d'activation mentionnée dans Tokenisation et paiements récurrents. Une fois activée, aucune intervention de ValPay n'est requise par jeton; le partenaire appelle directement l'API, de la même façon que pour tout autre paiement.
Résumé
Utilisez le guide Processus de migration des jetons (tokens) vers Adyen lorsqu'un commerçant a déjà un jeton à transférer; ce processus exige réellement que ValPay récupère et téléverse un fichier. Utilisez ce processus d'autorisation à valeur nulle lorsqu'il n'y a aucun jeton existant et qu'un partenaire doit tokeniser une carte directement par le biais de son intégration API existante, sans intervention de ValPay requise par demande.