Worldline / Saferpay
Worldline est connecté à edoobox via l’interface Saferpay. Les moyens de paiement disponibles dans le processus de réservation dépendent de votre contrat Worldline, du terminal, du pays, de la devise et de l’autorisation du prestataire. edoobox nécessite pour cela quatre valeurs d’accès et une version API.
Prérequis auprès du prestataire
Un contrat Worldline/Saferpay actif pour les paiements en ligne.
Une Customer ID et une Terminal ID.
Un utilisateur API ou une clé API et la Secret Key correspondante.
Des moyens de paiement et devises autorisés, ainsi qu’une procédure de versement coordonnée.
Les conditions actuelles et les moyens de paiement pris en charge proviennent de votre contrat prestataire. Les anciens noms de formules ou exemples de prix ne constituent pas une base fiable pour ce guide technique.
Enregistrer les identifiants dans edoobox
Ouvrez Paramètres → Systèmes de paiement → Worldline.
Saisissez Customer ID, Terminal ID, clé API et Secret Key.
Choisissez la version 1.50 proposée dans edoobox pour cette intégration.
Cliquez sur Enregistrer. Le bouton reste désactivé tant que des valeurs obligatoires manquent.
Vérifiez l’option d’activation et effectuez immédiatement un paiement de test interne.
La version 1.23 est obsolète : V2 propose toujours 1.23 dans la sélection et signale son obsolescence. Pour les configurations nouvelles ou actualisées, utilisez la version 1.50 et coordonnez la transition avec Worldline.
Le choix de version désigne l’interface Saferpay utilisée par cette intégration edoobox. Le prestataire peut déjà documenter des versions plus récentes ; leurs fonctions ne sont pas automatiquement disponibles dans edoobox pour autant. Vérifiez les moyens de paiement nécessaires et les versions minimales avec Worldline. La correspondance est expliquée dans la documentation Saferpay sur les versions.
Modifier la clé API et le secret en sécurité
Les secrets existants ne sont pas rechargés en clair dans le formulaire. V2 affiche à la place une représentation masquée. Laissez un champ secret vide si la valeur enregistrée doit rester inchangée ; saisissez une nouvelle valeur uniquement lors d’une rotation délibérée.
Customer ID et Terminal ID restent visibles et peuvent être modifiés séparément. Lors de l’enregistrement, V2 n’envoie que les éléments d’accès réellement modifiés. N’affichez la clé API ou Secret Key ni dans des captures d’écran ni dans des messages au support.
Contrôler le statut actif après l’enregistrement
Une configuration incomplète ne peut pas être activée. À l’ouverture, l’interface V2 actuelle vérifie aussi si une configuration complète existe et peut activer un enregistrement complet jusque-là inactif. Vérifiez donc délibérément l’option après chaque ouverture ou modification.
Actif signifie seulement qu’edoobox peut proposer ce mode de paiement. Seul un paiement prestataire réussi avec retour et transaction corrects montre qu’une méthode précise fonctionne.
Remboursement via Worldline/Saferpay
V2 prend en charge les remboursements d’une transaction Saferpay d’origine remboursable. Le montant doit être positif et ne peut pas dépasser le montant remboursable restant. edoobox envoie à Saferpay l’identifiant de transaction du prestataire, le montant, la devise et les identifiants API enregistrés.
Selon le statut du prestataire, un remboursement est directement signalé comme enregistré ou enregistré ensuite. En cas d’erreur du prestataire, V2 affiche plus longtemps le message Saferpay pour vous permettre d’en noter le motif précis.
Réinitialiser la configuration
Réinitialiser supprime dans edoobox Customer ID, Terminal ID, l’accès API et le secret, définit la version 1.50 et désactive Worldline. N’utilisez pas cette action comme étape normale de test.
Avant la réinitialisation : vérifiez les offres publiées, paiements en cours et remboursements ouverts. Conservez les données du prestataire en dehors d’edoobox selon votre procédure de sécurité si une reconnexion ultérieure est nécessaire.
Matrice de test
Configuration complète en version 1.50 et statut actif vérifié délibérément.
Paiement réussi avec chaque méthode réellement proposée par le contrat.
Abandon ou refus chez le prestataire sans statut de paiement edoobox erroné.
Rotation de secret sans écrasement des champs inchangés.
Remboursement partiel et seconde opération dans la limite du montant restant.
Erreur de remboursement avec message du prestataire documenté.
Exemple d’utilisation : nouvelle connexion Saferpay 1.50
L’administration reçoit quatre valeurs d’accès de Worldline, les enregistre avec la version 1.50 et vérifie le statut actif. Un paiement interne contrôle le retour du prestataire, la transaction edoobox, la réservation et l’e-mail de confirmation.
Exemple d’utilisation : rotation de la Secret Key
Worldline fournit une nouvelle Secret Key. L’équipe saisit uniquement le nouveau secret, laisse vide le champ de la clé API toujours valide et enregistre. Un paiement de test est ensuite effectué immédiatement, sans documenter les secrets dans une capture d’écran.
Exemple d’utilisation : un remboursement partiel échoue d’abord
Une transaction Saferpay se trouve encore dans un statut prestataire inadapté. edoobox affiche le message précis de remboursement. L’équipe note l’identifiant du prestataire et le texte, attend le statut correct et réessaie uniquement pour le montant toujours remboursable.
Contrôler la connexion actuelle et l’objet du paiement
Si un mode de paiement est autorisé dans le compte Worldline, testez-le avec la devise réellement utilisée par l’offre. L’option d’activation edoobox confirme seulement la connexion configurée ; le contrat et le terminal continuent de déterminer quelles méthodes sont acceptées.
En cas d’erreur, notez le montant, la devise, la date, le numéro de réservation et la référence du prestataire. Dans son portail, vérifiez si un paiement ou remboursement réussi existe déjà avant de relancer la même opération.