Worldpay
Connectez Worldpay à DEUNA, configurez les notifications de paiement et vérifiez le flux de paiement complet avant la mise en ligne.
Sur cette page
Connectez votre compte Worldpay dans DEUNA Admin, puis configurez Worldpay pour envoyer les mises à jour des transactions à DEUNA. Les deux étapes sont importantes : l'enregistrement d'une connexion ajoute vos informations d'identification, tandis que les notifications permettent à DEUNA de rapprocher les résultats de paiement après le traitement.
Avant de commencer#
Ce guide s’adresse aux personnes qui gèrent les connexions de paiement de leur entreprise ou boutique. Vous devez avoir accès à Connexions dans DEUNA Admin et à Worldpay Merchant Administration Interface (MAI). Si nécessaire, demandez ces accès à l’administrateur de votre compte.
Confirmez votre compte et vos identifiants
Préparez les éléments suivants pour l'environnement que vous configurez :
- Un compte Worldpay activé et son identifiant marchand.
- Les identifiants de connexion XML Worldpay, notamment les valeurs nommées Clé privée et Clé publique dans DEUNA.
- Les identifiants de connexion à Worldpay MAI pour configurer les notifications.
- Accès au commerçant ou au magasin où la connexion DEUNA sera créée.
Demandez ces informations d’identification à votre représentant Worldpay. Confirmez que les informations d'identification prennent en charge l'opération et l'environnement sélectionnés ; Les informations de connexion MAI et les informations de connexion XML servent à des fins différentes. Saisissez les informations de connexion uniquement dans l'administrateur DEUNA et conservez-les à l'écart du code de paiement, des captures d'écran et des messages d'assistance.
Confirmer la disponibilité du paiement
Vérifiez le catalogue des capacités Worldpay pour votre marché, votre devise, vos marques de cartes et les opérations requises. La disponibilité dépend du compte et de la connexion ; les descriptions des fonctionnalités ci-dessous n'impliquent pas que chaque fonctionnalité est activée pour chaque commerçant.
Confirmez auprès de Worldpay les exigences d’acquisition locale et d’entité juridique pour chaque pays. Si vous prévoyez d’utiliser 3-D Secure, les paiements échelonnés, les portefeuilles ou plusieurs opérations partielles, convenez de la configuration nécessaire avec DEUNA et Worldpay avant les tests.
Devises acceptées
ARS · BRL · EUR · GBP · JPY · MXN · USD
La disponibilité des devises dépend du compte marchand Worldpay et de la connexion. Confirmez les devises activées pour votre compte avant les tests.
1. Connectez Worldpay dans DEUNA#
Ouvrez Administrateur DEUNA, sélectionnez le marchand ou la boutique concernés et ouvrez Connexions. Dans Découvrir, recherchez Worldpay et sélectionnez Connecter.
L’aperçu présente la recherche de Worldpay, la configuration des identifiants et la connexion enregistrée. Ses commandes sont illustratives ; configurez votre compte réel dans DEUNA Admin.
Entrez les paramètres de connexion
- Choisissez un nom de connexion reconnaissable afin que votre équipe puisse le distinguer des autres comptes ou environnements.
- Sélectionnez la devise lorsque cela vous est demandé et entrez les informations d'identification Worldpay émises pour cette connexion.
- Choisissez Achat pour autoriser et demander la capture dans un seul flux de paiement, ou Autorisation si vous enverrez une demande de capture distincte ultérieurement.
- Configurez 3-D Secure uniquement après avoir confirmé le flux d'authentification pris en charge avec DEUNA. Voir Gestion sécurisée 3D avant de mettre en œuvre le paiement.
- Sélectionnez Connecter, puis vérifiez que Worldpay apparaît sous Connexions actives.
| Champ DEUNA | Valeur à saisir |
|---|---|
| Merchant ID | L'ID marchand Worldpay émis pour la connexion. |
| Clé privée | Clé privée XML Worldpay. |
| Clé publique | Le mot de passe public XML Worldpay. |
Pour les paiements des compagnies aériennes, remplissez également les champs d'émetteur requis par votre configuration : Nom de l'émetteur, Adresse de l'émetteur1, Code postal de l'émetteur, Ville de l'émetteur et Code du pays de l'émetteur. Ceux-ci identifient la compagnie aérienne émettrice du billet ; utiliser un code pays ISO à deux lettres pour son pays. Ils ne remplacent pas les données du passager, du billet et de l'itinéraire envoyées avec un paiement.
Une connexion sous Active Connections confirme qu'elle a été enregistrée. Continuez avec les notifications Worldpay et un test de paiement avant de considérer l'intégration comme prête.
2. Configurez les notifications Worldpay#
Worldpay envoie des notifications à DEUNA pour mettre à jour le paiement après une autorisation, une capture, une annulation ou un remboursement. Votre backend reçoit les mises à jour via une configuration distincte de webhooks DEUNA. Configurez les deux circuits si votre intégration nécessite des mises à jour asynchrones.
Voir Notifications de statut de paiement DEUNA pour la configuration côté marchand.
Définir l'adresse de notification
Dans Worldpay MAI, ouvrez Integration → Merchant Channel. Dans le http rangée, ensemble Active à Yes, définir Method à POST, puis entrez l'adresse de notification pour l'environnement correspondant.
| Environnement | Adresse de notification Worldpay |
|---|---|
| Bac à sable | https://api.sandbox.deuna.io/transactions/webhooks/payconnect/payment-processors/worldpay |
| Fabrication | https://api.deuna.io/transactions/webhooks/payconnect/payment-processors/worldpay |
Confirmez l'adresse avec DEUNA pour votre connexion avant de l'enregistrer. Worldpay appelle cette adresse ; votre application ne l'appelle pas pour créer un paiement ou récupérer son statut.
Activer les événements de transaction
Dans Merchant Channel Events (Production), sélectionnez les événements suivants dans le http rangée. Conservez les identifiants d’événement exactement comme indiqué.
| Étape de paiement | Événements à activer |
|---|---|
| Autorisation et erreurs | AUTHORIZED, REFUSED, ERROR |
| Capture | CAPTURED, CAPTURE_FAILED |
| Remboursement | SENT_FOR_REFUND, REFUNDED, REFUNDED_BY_MERCHANT, REFUND_REVERSED, REFUND_FAILED |
| Annulation et annulation | SHOPPER_CANCELLED, CANCELLED, REVERSED, VOIDED, CANCEL_FAILED |
3. Testez le flux de paiement complet#
Utilisez les informations d'identification du bac à sable et le flux de paiement pris en charge par votre connexion. Un test de connexion réussi doit montrer à la fois l'opération de paiement demandée et son état résultant.
Les demandes de capture, de remboursement et d’annulation peuvent rester en attente pendant leur traitement par Worldpay. L’acceptation d’une demande, le retour du navigateur ou un délai dépassé ne confirment pas le résultat final. Utilisez le dernier statut de la commande et les webhooks DEUNA configurés pour rapprocher le paiement initial avant de réessayer ou de considérer l’opération comme terminée.
Voir Flux de travail et statuts de paiement pour le cycle de vie des paiements et Webhooks DEUNA pour les notifications back-end.
Si le résultat attendu n'arrive pas
- Si la connexion ne peut pas être enregistrée, vérifiez le compte, l'environnement, le fonctionnement et les informations d'identification XML sélectionnés avec Worldpay.
- Si un paiement reste en attente, vérifiez l'adresse de notification Worldpay,
POSTméthode et sélectionnéhttpévénements avant de réessayer l’opération d’origine. - Si DEUNA a le résultat mais pas votre backend, vérifiez votre Configuration de la livraison du webhook DEUNA.
Lors d'une transmission vers DEUNA, incluez l'environnement, la référence de la commande, la tentative d'opération et l'état observé. N'incluez pas les informations d'identification ni les données complètes de la carte.
Passer à la production
Répétez la configuration de la connexion et de la notification avec les informations d'identification de production et l'adresse de notification de production. Confirmez les opérations activées et toutes les exigences de certification avec DEUNA et Worldpay, puis vérifiez le flux de paiement de la production avant d'accepter le trafic client.
Opérations prises en charge#
Utilisez cette référence pour choisir le flux de paiement à configurer et tester. Confirmez chaque fonctionnalité par rapport au catalogue des capacités Worldpay et la configuration de votre compte.
| Fonctionnalité | Ce que ça fait |
|---|---|
| Autorisation | Réserve le montant demandé sur le compte du titulaire sans capturer les fonds. Une capture distincte est nécessaire pour encaisser le paiement. |
| Capture | Encaisse les fonds d'un paiement précédemment autorisé. Une capture intégrale encaisse le montant autorisé disponible. |
| Achat | Autorise le paiement et demande sa capture dans un même flux, sans requête de capture distincte du marchand. |
| Capture partielle | Capture une partie du montant précédemment autorisé. Les captures multiples nécessitent une activation distincte. |
| Captures partielles multiples | Permet plusieurs captures sur une même autorisation, sans dépasser le solde autorisé disponible. Le mode de fonctionnement et la validité de l'autorisation déterminent comment et quand soumettre les captures. |
| Annulation | Annule une autorisation non capturée et demande la libération du montant encore réservé. Ne rembourse pas les fonds déjà capturés. |
| Remboursements | Restitue les fonds capturés au titulaire. Un remboursement intégral restitue le solde remboursable restant. |
| Remboursements partiels | Restitue une partie du montant capturé au titulaire. |
| Remboursements partiels multiples | Permet plusieurs remboursements sur un même paiement capturé lorsque cette fonction est activée. Le total remboursé ne peut pas dépasser le montant capturé confirmé. |
| Paiement échelonné par l'émetteur | Permet aux titulaires éligibles d'échelonner un achat selon les conditions prises en charge par l'émetteur, l'acquéreur et la connexion du marchand. |
| Portefeuilles numériques | Prend en charge les paiements Apple Pay et Google Pay lorsque le portefeuille est disponible et activé pour la connexion Worldpay. |
| MPI 3-D Secure | DEUNA gère l'authentification 3-D Secure, notamment les vérifications du navigateur et un challenge de l'émetteur si nécessaire. L'authentification peut aussi se terminer sans challenge visible. |
| Données des lignes aériennes | Transmet les informations aériennes prises en charge, notamment les passagers, billets et itinéraires. Fournissez les données aériennes nécessaires à votre flux de paiement. |
Captures et remboursements multiples
La prise en charge des captures et remboursements partiels n'active pas automatiquement les opérations multiples. Confirmez le mode de fonctionnement et les limites par commande auprès de votre Technical Account Manager (TAM) DEUNA et de Worldpay.
En mode en ligne, chaque capture est envoyée individuellement à Worldpay, sans échéance de capture DEUNA. La validité de l'autorisation et les limites de capture Worldpay restent applicables. Une période de capture configurée dans DEUNA concerne les captures mises en attente (mode hors ligne), dont DEUNA soumet le montant cumulé à la clôture de la séquence. Consultez Captures partielles multiples pour les règles propres à chaque mode.
Les remboursements multiples doivent rester dans la limite du solde remboursable confirmé. Si la connexion utilise la mise en attente gérée par DEUNA, une demande partielle enregistre une intention jusqu'à l'envoi du remboursement cumulé ; elle ne signifie pas que le client a reçu les fonds. Consultez Remboursements partiels multiples pour le flux avec mise en attente.
Gérer l’authentification 3-D Secure
Lorsque l'authentification nécessite une action du navigateur, DEUNA renvoie l'expérience hébergée dans l'action suivante du paiement. Votre intégration la présente via le widget, l'iframe ou la redirection pris en charge. Les vérifications du navigateur peuvent se terminer sans challenge de l'émetteur ; le titulaire n'en voit un que si nécessaire.
Une authentification réussie ne garantit pas l'approbation ou la capture du paiement. Confirmez le statut final une fois que DEUNA a terminé l'autorisation ou le traitement restant. Suivez le Flux d'achat 3DS pour gérer l'action suivante et la reprise.
Portefeuilles et versements
Complétez le séparé Apple Pay ou Google Pay configuration avant de proposer un portefeuille à la caisse. La disponibilité du portefeuille dépend du marché et de la connexion.
Pour les versements de l'émetteur, proposez uniquement les conditions éligibles pour la carte, l'acquéreur et la connexion. Voir Versements pour configurer les campagnes et soumettre l'option choisie par le client.
Exigences régionales et aériennes#
Paiements des compagnies aériennes
Fournissez les données de la compagnie aérienne requises par votre flux dans la demande d'autorisation ou de capture. Pour un airline_order, les données requises de la compagnie aérienne doivent être présentes dans au moins une de ces demandes. Confirmez les informations attendues sur le passager, le billet et l'itinéraire pour votre correspondance avant de tester.
Limites de capture et de remboursement
Capturez avant l’expiration de l’autorisation. Confirmez la fenêtre de capture autorisée avec Worldpay et DEUNA ; une limite de lot DEUNA ne prolonge pas l'autorisation de l'émetteur. Les remboursements ne peuvent pas dépasser le montant capturé confirmé. Suivez le règles du mode de fonctionnement avant de soumettre plusieurs opérations partielles.
Transactions locales en Argentine
Pour les transactions acquises localement par Worldpay en Argentine, indiquez le code postal, la province et le pays de l'acheteur dans la demande d'autorisation :
billing_address.zipcodebilling_address.state_namebilling_address.country_code
Worldpay utilise ces informations pour la retenue d'impôt provincial. En cas d'absence, la retenue est fonction de la localisation du commerçant. Envoyez soit le code de province ISO, soit le code COMARB dans billing_address.state_name, pas les deux.
Codes provinciaux de l'Argentine
| Code de la province COMARB | Code de la province ISO | Nom de la province |
|---|---|---|
| 901 | AR-C | CABA |
| 909 | AR-P | Formose |
| 919 | AR-D | San Luis |
| 908 | AR-E | Entre Ríos |
| 911 | AR-L | La Pampa |
| 917 | AR-A | Salta |
| 906 | AR-H | Chaco |
| 907 | AR-U | Chubut |
| 910 | AR-Y | Jujuy |
| 920 | AR-Z | Sainte-Cruz |
| 903 | AR-K | Catamarca |
| 904 | AR-X | Cordoue |
| 912 | AR-F | La Rioja |
| 922 | AR-G | Santiago de l'Estero |
| 918 | AR-J | Saint-Jean |
| 913 | AR-M | Mendoza |
| 914 | AR-N | Missions |
| 915 | AR-Q | Neuquén |
| 916 | AR-R | Río Negro |
| 923 | AR-V | Terre de Feu |
| 902 | AR-B | Buenos Aires |
| 921 | AR-S | Santa Fé |
| 924 | AR-T | Tucumán |
| 905 | AR-W | Corrientes |
Prochaines étapes#
- Stratégies de paiement: configurer quand le compte connecté est utilisé.
- Flux d'achat 3DS: gérer les actions du navigateur, les résultats d'authentification et la récupération.
- Notifications sur l'état du paiement: gardez votre backend aligné sur DEUNA.