API

Connectez Worldline à votre boutique et à votre ERP

Votre boutique, le paiement et l’ERP doivent retrouver la même commande et comprendre son état. Dawap développe les échanges qui suivent les opérations Worldline jusqu’à vos outils de gestion. Le travail commence par l’identification de votre solution et des interfaces réellement disponibles.

APIs, données et infrastructures que nos projets savent connecter
Conception, intégration et maintenance
01 Contrat versionné
02 Sécurité explicite
03 Reprise testée
04 Supervision avec alertes

Votre solution Worldline

Identifier la bonne interface avant de relier les opérations.

Worldline Direct, Connect et Sips disposent de documentations et de parcours propres. Nous vérifions votre contrat, votre module et votre environnement avant de définir les événements à traiter, les appels API et les règles à appliquer dans le SI.

  • Associer les opérations aux commandes et au bon compte marchand.
  • Distinguer une demande en cours de son résultat.
  • Prévoir les reprises et le suivi des écarts dans la gestion.

Situations à résoudre

Les écarts entre le parcours client et vos outils internes

Nous partons des dossiers que le support ou la finance doit encore reconstituer dans plusieurs interfaces.

01 Retour client

La page de retour ne permet pas de conclure

Le client revient dans la boutique alors que l’opération attend encore une réponse. Le message affiché et le statut de commande doivent refléter cette attente.

02 Suivi

Une capture ou un remboursement perd son lien avec la vente

Les identifiants et les états des opérations évoluent. Le connecteur doit conserver leur correspondance avec la commande.

03 Gestion

Une opération réussit, mais sa transmission échoue

Le paiement et l’écriture ERP suivent des traitements séparés. Le support doit reprendre le bon échange sans répéter le mouvement financier.

Développements Worldline

Relier les événements de paiement aux opérations de gestion

Le périmètre dépend de votre solution Worldline, du module installé et des interfaces de vos logiciels.

01 · Worldline

Parcours de paiement

Intégrer le parcours adapté à votre solution et gérer les résultats en attente, les abandons et le retour du client dans la boutique.

02 · Worldline

Références et historique

Relier les identifiants de paiement et de modification à la commande, au compte marchand et aux opérations déjà réalisées.

03 · Worldline

Notifications et contrôles

Vérifier les notifications selon le mécanisme de l’offre utilisée, gérer les répétitions et prévoir une consultation API en cas de suivi incomplet.

04 · Worldline

Captures et préparation

Définir les règles de capture et les transmettre aux outils qui préparent la vente, selon les fonctions et moyens de paiement disponibles.

05 · Worldline

Remboursements et avoirs

Associer les résultats du remboursement aux retours et aux corrections attendues dans l’ERP, en conservant les étapes de traitement.

06 · Worldline

Rapprochement financier

Exploiter les données et rapports accessibles pour rapprocher opérations, frais et règlements avec les références de votre gestion.

Méthode

Construire les échanges avec la DSI et les équipes de gestion

Nous identifions la solution et les opérations existantes, puis définissons les actions autorisées dans chaque logiciel. Les tests couvrent le parcours normal, les états d’attente et la reprise des échanges interrompus.

01

Identifier la solution

Offre Worldline, module, compte et environnement.

02

Définir les correspondances

Commandes, opérations et états attendus dans l’ERP.

03

Tester les incidents

Notification répétée, résultat tardif et erreur de transmission.

04

Organiser le suivi

Alertes, documentation et responsabilités de maintenance.

Démarrer le projet

Résoudre un premier écart entre paiement et gestion.

Présentez votre installation et une opération que vos équipes doivent encore vérifier à la main. Nous définirons les échanges à développer et les contrôles nécessaires.

Le périmètre à définir

01

Installation Solution, module et fonctions accessibles.

02

Références Commandes, comptes et opérations à rapprocher.

03

Contrôles États, erreurs, notifications et reprises.

04

Livraison Recette, déploiement, documentation et maintenance.

Exemples de recette Worldline Direct

Trois situations à vérifier dans le parcours retenu

Ces exemples utilisent Worldline Direct. Les ressources et contrôles sont adaptés si votre installation utilise Connect, Sips ou un module intermédiaire.

01 · Retour du client

Le navigateur revient avant le résultat final

Le serveur consulte GetHostedCheckoutStatus pour une page de paiement hébergée, ou GetPaymentDetails pour le parcours serveur concerné. La boutique peut afficher une attente ; le seul retour navigateur ne valide pas la commande.

Entrée
Parcours, référence et état disponible.
Sortie
Un message client et une transition de commande cohérents.
Décision
Attendre le résultat nécessaire à la règle métier.
02 · Historique des opérations

L’identifiant évolue après une opération de maintenance

Avec Worldline Direct, payment.id peut changer au cours du cycle. Le connecteur retrouve les opérations depuis l’API et conserve leur lien avec la commande, sans déduire leur identité d’un numéro supposé incrémental.

Entrée
Paiement, liste des opérations et références internes.
Sortie
Un historique reliant captures et remboursements.
Décision
Rapprocher les identifiants retournés par l’API.
03 · Notification répétée

Le même changement d’état arrive à nouveau

Le traitement reconnaît le paiement et le type d’événement. Il contrôle les actions déjà exécutées avant de transmettre le nouvel état, puis suit séparément la réussite de l’écriture ERP.

Entrée
Notification, paiement et résultat de transmission.
Sortie
Une reprise limitée à l’échange incomplet.
Décision
Éviter une seconde action sur une opération déjà traitée.
Projet de paiement sur mesure

Saybus : réservation, paiement et facturation

Dawap a développé les échanges entre la réservation Saybus, Stripe et les outils internes. Ce projet illustre le suivi d’une vente dans un logiciel métier ; il utilise Stripe.

Plateforme Bus Booking pour réservation d'autocars, calculateur et back-office Développement web Saybus / Réunir : Bus Booking Voir le projet
  • 05 avril 2022
  • Lecture ~32 min

Saybus devait transformer une demande d’autocar en commande exploitable sans perdre calcul, paiement ni suivi interne. Dawap a conçu une plateforme avec Google Places, ViaMichelin, Stripe, empreinte bancaire, documents PDF, facturation et back-office pour piloter chaque dossier jusqu’à l’exploitation.

Guide technique

Préparer les échanges autour de Worldline

Un complément pour examiner les états et les opérations à relier à votre SI.

Questions fréquentes

Questions sur votre intégration Worldline

Les choix à préciser avant le développement.

01Les API Worldline sont-elles identiques pour toutes les offres ?

Non. Direct, Connect et Sips disposent de leurs propres ressources et parcours. Nous identifions votre solution, sa version et les fonctions de votre compte avant de proposer l’intégration. Un mécanisme de signature ou un statut ne se transpose pas automatiquement d’une offre à l’autre.

02Faut-il remplacer notre module e-commerce ?

Pas nécessairement. S’il couvre le paiement, le développement peut se limiter aux échanges manquants avec votre ERP ou votre support. Nous précisons quel composant déclenche chaque capture et remboursement.

03Le retour de la page de paiement suffit-il à confirmer la commande ?

Non. Le résultat doit être vérifié côté serveur selon le parcours utilisé. Pour Worldline Direct, la documentation prévoit des consultations API adaptées au parcours hébergé ou serveur ; les webhooks assurent aussi le suivi des changements ultérieurs.

04Comment sécurisez-vous les notifications ?

Nous appliquons la vérification de signature et les paramètres du bon environnement selon la solution retenue. Le connecteur enregistre les événements et contrôle les actions déjà réalisées. La recette couvre les répétitions et les notifications manquées.

05Pourquoi conserver plusieurs identifiants pour une commande ?

Le paiement initial, une capture et un remboursement peuvent être représentés par des opérations distinctes. Avec Worldline Direct, payment.id peut évoluer. Nous conservons les références retournées et leurs liens, sans reconstruire les identifiants par calcul.

06Pouvez-vous gérer captures et remboursements partiels ?

Nous vérifions les fonctions du contrat, du moyen de paiement et du module. Les opérations retenues sont reliées aux commandes et aux avoirs, avec suivi de leur résultat et des erreurs de transmission.

07Comment traitez-vous un résultat incertain ?

Le connecteur conserve la demande, consulte les informations disponibles et signale les dossiers qui nécessitent une vérification. Une absence de réponse ne déclenche pas automatiquement un nouveau paiement, notamment auprès d’un autre prestataire.

08Comment se déroule la livraison ?

La proposition définit les échanges, les tests, la documentation et la maintenance. La mise en service est organisée avec votre DSI et les responsables des logiciels connectés, chez Dawap ou dans votre infrastructure.

Intégration Worldline et système d’information

Reliez Worldline aux outils qui suivent vos ventes.

Présentez votre solution de paiement, votre boutique et votre ERP. Nous définirons les échanges et les contrôles adaptés à votre installation.

Étudier mon intégration Worldline