Aller au contenu principal
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.

01
Préparer
Confirmez l'accès au compte, les informations d'identification et les opérations prises en charge.
02
Connectez-vous dans DEUNA
Ajoutez Worldpay et choisissez la manière dont les paiements sont traités.
03
Configurer les notifications
Activez les événements Worldpay qui maintiennent DEUNA à jour.
04
Vérifier le flux
Testez les résultats de paiement avant d’utiliser les informations d’identification de production.

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.

DEUNA Admin · Aperçu de la configuration
ConnexionsBac à sable
DécouvrirActives
Rechercher des connexions
Worldpay
Passerelle de paiementWorldpay
Exemple de configuration. Aucune information d’identification n’est envoyée.

Entrez les paramètres de connexion

  1. Choisissez un nom de connexion reconnaissable afin que votre équipe puisse le distinguer des autres comptes ou environnements.
  2. Sélectionnez la devise lorsque cela vous est demandé et entrez les informations d'identification Worldpay émises pour cette connexion.
  3. 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.
  4. 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.
  5. Sélectionnez Connecter, puis vérifiez que Worldpay apparaît sous Connexions actives.
Champ DEUNAValeur à saisir
Merchant IDL'ID marchand Worldpay émis pour la connexion.
Clé privéeClé privée XML Worldpay.
Clé publiqueLe 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.

EnvironnementAdresse de notification Worldpay
Bac à sablehttps://api.sandbox.deuna.io/transactions/webhooks/payconnect/payment-processors/worldpay
Fabricationhttps://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.

Worldpay MAI: use the http row to configure notification delivery. Labels in Worldpay's own interface may differ from your documentation language.

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 erreursAUTHORIZED, REFUSED, ERROR
CaptureCAPTURED, CAPTURE_FAILED
RemboursementSENT_FOR_REFUND, REFUNDED, REFUNDED_BY_MERCHANT, REFUND_REVERSED, REFUND_FAILED
Annulation et annulationSHOPPER_CANCELLED, CANCELLED, REVERSED, VOIDED, CANCEL_FAILED
Worldpay MAI: enable the listed events in the http row, then save the configuration.

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, POST mé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
AutorisationRéserve le montant demandé sur le compte du titulaire sans capturer les fonds. Une capture distincte est nécessaire pour encaisser le paiement.
CaptureEncaisse les fonds d'un paiement précédemment autorisé. Une capture intégrale encaisse le montant autorisé disponible.
AchatAutorise le paiement et demande sa capture dans un même flux, sans requête de capture distincte du marchand.
Capture partielleCapture une partie du montant précédemment autorisé. Les captures multiples nécessitent une activation distincte.
Captures partielles multiplesPermet 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.
AnnulationAnnule une autorisation non capturée et demande la libération du montant encore réservé. Ne rembourse pas les fonds déjà capturés.
RemboursementsRestitue les fonds capturés au titulaire. Un remboursement intégral restitue le solde remboursable restant.
Remboursements partielsRestitue une partie du montant capturé au titulaire.
Remboursements partiels multiplesPermet 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'émetteurPermet 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ériquesPrend en charge les paiements Apple Pay et Google Pay lorsque le portefeuille est disponible et activé pour la connexion Worldpay.
MPI 3-D SecureDEUNA 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ériennesTransmet 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.zipcode
  • billing_address.state_name
  • billing_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 COMARBCode de la province ISONom de la province
901AR-CCABA
909AR-PFormose
919AR-DSan Luis
908AR-EEntre Ríos
911AR-LLa Pampa
917AR-ASalta
906AR-HChaco
907AR-UChubut
910AR-YJujuy
920AR-ZSainte-Cruz
903AR-KCatamarca
904AR-XCordoue
912AR-FLa Rioja
922AR-GSantiago de l'Estero
918AR-JSaint-Jean
913AR-MMendoza
914AR-NMissions
915AR-QNeuquén
916AR-RRío Negro
923AR-VTerre de Feu
902AR-BBuenos Aires
921AR-SSanta Fé
924AR-TTucumán
905AR-WCorrientes

Prochaines étapes#