Pourquoi les URL des API Bambora et Beanstream changent-elles ?

Shift4 a acquis Bambora et Beanstream et consolide toutes les plateformes sous la marque Shift4. Dans le cadre de cette harmonisation, tous les points de terminaison API et les URL du portail web qui utilisaient auparavant les domaines Bambora ou Beanstream sont transférés vers une convention de domaine appartenant à Shift4.

Il s'agit uniquement d'un changement de marque et d'infrastructure. Aucune fonctionnalité n'est modifiée.

À savoir :

  • Les nouveaux points de terminaison sont actifs depuis le 25 août 2026, vous pouvez commencer à mettre à jour et à tester immédiatement après cette date. Consultez la liste complète des correspondances des points de terminaison ici.
  • Vous devez mettre à jour votre intégration avant le 31 décembre 2026.
  • Seul le domaine change, la fonctionnalité API, les identifiants et les données ne sont pas affectés.

Comprendre l’impact

Cela affecte-t-il la fonctionnalité de mon API, mes données ou l’historique des transactions ?

Non. Le comportement de l’API, les formats des requêtes et réponses, l’authentification, ainsi que toutes les données de transaction restent identiques. Il s’agit uniquement d’un changement d’URL.

Je suis un commerçant. Cela m’affecte-t-il directement ?

Cela dépend de la manière dont vous accédez aux services Shift4.

Si vos systèmes se connectent directement aux points de terminaison API Bambora/Beanstream (généralement géré par un développeur interne, une agence informatique ou un fournisseur de logiciel tiers), ces intégrations doivent être mises à jour. Transmettez ce document à l’équipe technique appropriée.

J’envoie mes clients vers une page de paiement hébergée. Dois-je faire quelque chose ?

Oui. Si vous redirigez vos clients directement vers notre solution de paiement hébergée, cette URL doit être mise à jour.

Seule la première partie de l’URL (le domaine) doit changer. Tout ce qui suit — votre identifiant marchand, le montant, les détails de la commande et tous les autres paramètres — reste exactement le même.

Avant : https://web.na.bambora.com/scripts/payment/payment.asp?merchant_id=123456789&trnAmount=19.99...

Après : https://checkout.bam.shift4api.net/payment/payment.asp?merchant_id=123456789&trnAmount=19.99...

En d’autres termes, remplacez : https://web.na.bambora.com par : https://checkout.bam.shift4api.net.

Le reste de l’URL, le chemin (/scripts/payment/payment.asp) et tous les paramètres après le point d’interrogation ne changent pas.

Si votre lien de paiement est codé en dur dans un site web, un modèle de facture, un courriel ou un bouton, transmettez-le à votre développeur ou fournisseur informatique et demandez-lui de ne modifier que la partie domaine.

J’utilise un fournisseur de logiciel tiers ou un plugin de paiement. Que dois-je faire ?

Transmettez ce document ainsi que le courriel de migration original à votre fournisseur de logiciel ou vendeur de plugin. Demandez-leur de confirmer si leur produit nécessite une mise à jour et quand ils prévoient de la publier.

Vous devriez également confirmer avec eux, avant la date limite du 31 décembre 2026, que la mise à jour a bien été appliquée.

Les adresses IP vont-elles changer ? Dois-je mettre à jour mon pare-feu ?

Des mises à jour des listes blanches du pare-feu peuvent être nécessaires. De nouvelles adresses IP seront fournies dans une communication ultérieure. Assurez-vous que votre équipe réseau ou informatique révise et met à jour les règles du pare-feu avant la mise en service du 31 décembre 2026.

Si votre pare-feu autorise actuellement le trafic par nom de domaine plutôt que par IP, vous devrez ajouter le nouveau domaine *.bam.shift4api.net à votre liste blanche.

J’ai reçu ce document d’un commerçant. Que dois-je faire en tant que développeur ou fournisseur informatique ?

En tant qu’implémenteur technique agissant pour le compte d’un commerçant, vous êtes responsable de :

  • Mettre à jour toutes les URL des points de terminaison API dans l’intégration du commerçant des domaines Bambora/Beanstream hérités vers la nouvelle convention de domaine Shift4.
  • Examiner et mettre à jour les listes blanches du pare-feu une fois que les nouvelles adresses IP seront fournies.
  • Tester l’intégration mise à jour dans un environnement de préproduction avant de déployer en production.
  • Compléter la migration avant le 31 décembre 2026.

Consultez la liste complète des correspondances des points de terminaison ici pour toutes les URL concernées.

Pour les développeurs et équipes techniques

Comment mettre à jour mon intégration pour le rebranding du domaine API Shift4 ?

Le processus de mise à jour dépend de la façon dont votre intégration est construite, mais les étapes sont généralement les suivantes :

  • Localisez toutes les références aux domaines Bambora/Beanstream dans votre base de code, fichiers de configuration, variables d’environnement et infrastructure (par exemple, DNS, répartiteur de charge, règles de pare-feu).
  • Remplacez toutes les occurrences par le point de terminaison correspondant. Consultez la liste complète des correspondances des points de terminaison ici.
  • Mettez à jour toute liaison ou validation de certificat TLS/SSL qui fait référence à l’ancien domaine.
  • Mettez à jour les listes blanches du pare-feu pour autoriser le trafic vers les nouvelles adresses IP (qui seront fournies dans une communication ultérieure).
  • Testez votre intégration dans un environnement de préproduction ou bac à sable avant de déployer en production.
  • Déployez les changements en production avant le 31 décembre 2026.
Les méthodes d’authentification ou les clés API changent-elles ?

Non. Vos clés API, identifiants et méthodes d’authentification existants restent valides. Aucune ré-authentification ni rotation des identifiants n’est requise dans le cadre de cette migration.

Les formats de requête ou de réponse changent-ils ?

Non. Toutes les structures de requête API, formats de réponse, codes d’erreur, et schémas de données restent identiques. La logique d’intégration existante n’a pas besoin d’être modifiée au-delà de la mise à jour de l’URL.

Comment me préparer à cette mise à jour ?

Nous recommandons les étapes de préparation suivantes :

  • Consultez dès maintenant la liste des correspondances des points de terminaison et identifiez quelles URL votre système utilise.
  • Auditez votre base de code, pipelines CI/CD, configurations d’environnement, et infrastructure-as-code pour trouver les URL Bambora/Beanstream codées en dur.
  • Mettez à jour d’abord vos environnements de préproduction/développement et validez la fonctionnalité de bout en bout.
  • Planifiez votre déploiement en production avant la date limite du 31 décembre 2026 pour permettre du temps pour les tests.
  • Coordonnez-vous avec les fournisseurs tiers ou plugins pour confirmer qu’ils seront mis à jour à temps.
  • Surveillez la communication de suivi contenant les nouvelles adresses IP et mettez à jour les règles du pare-feu en conséquence.

Calendrier et échéances

Quel est le calendrier de cette migration ?
Date Événement Ce que cela signifie
25 août 2026 Mise en service des nouveaux points de terminaison Les nouveaux points de terminaison Shift4 deviennent actifs. Vous pouvez commencer à les utiliser immédiatement.
31 décembre 2026 Date limite de migration Toutes les intégrations doivent utiliser les nouveaux points de terminaison à cette date.
Que se passe-t-il si je rate la date limite de migration du 31 décembre 2026 ?

Après le 31 décembre 2026, les points de terminaison hérités seront désactivés de façon permanente et toutes les requêtes vers les URL héritées commenceront à échouer. Vous devez compléter la migration avant le 31 décembre 2026 pour éviter toute interruption.

Bon à savoir :

  • Les nouveaux points de terminaison sont en ligne et disponibles pour les tests avant la date limite, vous n’avez pas à attendre le 31 décembre.
  • Si un fournisseur tiers ou un plugin gère vos paiements, vous n’aurez peut-être rien à faire vous-même, mais vous devriez confirmer avec eux qu’ils feront la mise à jour à temps.
  • Vos clés API et authentifications ne changent pas, il n’est pas nécessaire de vous réenregistrer ou de réinitialiser vos identifiants.
  • Les règles du pare-feu peuvent devoir être mises à jour, de nouvelles adresses IP seront fournies dans une communication ultérieure.
Cet article vous a-t-il été utile?
Utilisateurs qui ont trouvé cela utile : 3 sur 4