À qui cela s'adresse-t-il ?
Tout marchand disposant déjà d'un compte de production CyberSource actif utilisant Hosted Checkout et souhaitant migrer vers Unified Checkout peut le faire. Aucun nouveau compte CyberSource n'est nécessaire : cette opération active simplement un nouveau service sur l'identifiant marchand (MID) de production existant et transfère la configuration d' OpenApply vers celui-ci.
⚠️ Dans OpenApply , le mode CyberSource ( Hosted Checkout vs Unified Checkout ) est un paramètre unique par établissement scolaire , et non par utilisateur ou par session. Dès qu'il est activé, tous les parents de cet établissement utilisent l'emprunt unifié. Comme il n'y a pas de déploiement progressif ni de prévisualisation réservée au personnel, veuillez prendre vos dispositions en conséquence.
Liste de contrôle
- Soumettez une demande de configuration MID pour activer le paiement unifié, l'authentification du payeur (3DS) et le gestionnaire de décisions sur le MID de production.
- Générez une nouvelle clé d'API REST une fois le service approuvé.
- Pendant une période de faible trafic : sauvegardez les identifiants Hosted Checkout, puis basculez OpenApply vers Unified Checkout avec la nouvelle clé et la case à cocher Decision Manager.
- Configurer le webhook Unified Checkout
- Validez avec une transaction réelle, puis maintenez la bascule ou annulez-la.
Étape 1 : Activer le service (Activation du service)
Dans le Centre d'affaires, ouvrez Assistance → Centre d'assistance :
Ceci ouvre le Centre d'assistance Visa Acceptance Solutions. Accédez à Demandes d'assistance → Demande de configuration MID :
Soumettez le formulaire en cochant uniquement « Activation du service » et demandez :
- Paiement unifié (API REST)
- Authentification du payeur (3DS)
- Gestionnaire de décisions (si un contrôle des fraudes est nécessaire)
Dans la section Environnement , cochez uniquement Production . Laissez la case Privé cochée.
Pour toute question spécifique à CyberSource, veuillez contacter directement le support CyberSource.
CyberSource traite cette demande en interne (d'après sa documentation publique, généralement sous 3 jours ouvrés). Aucune autre étape de ce processus ne peut être menée tant que cette demande n'est pas approuvée, car la clé REST créée à l'étape 2 et la case à cocher « Gestionnaire de décisions » à l'étape 3 dépendent de l'activation préalable de ces services sur le compte marchand.
Étape 2 : Générer et enregistrer la nouvelle clé API REST
⚠️ La clé de paiement unifié est différente de celle du paiement hébergé , même si elles appartiennent au même marchand/profil. Le paiement hébergé utilise une clé d'accès sécurisée et une clé secrète ; le paiement unifié utilise une clé API REST distincte (ID de clé et secret partagé). Ces clés sont stockées à des emplacements différents dans Business Center et ne sont pas interchangeables.
Une fois le service activé, accédez à Centre d'affaires → Configuration des paiements → Gestion des clés :
Cliquer + Générer la clé :
Sélectionnez le type de clé REST - Secret partagé , le type recommandé pour les API REST utilisées par Unified Checkout :
Ignorez les options SCMP/SOAP Toolkit héritées ci-dessous (CyberSource les a marquées comme obsolètes) et cliquez sur Générer la clé :
Confirmer la génération :
Copiez (ou téléchargez) immédiatement la clé et le secret partagé , car CyberSource n'affiche le secret partagé qu'une seule fois :
Étape 3 : Sauvegardez Hosted Checkout, puis passez OpenApply à Unified Checkout.
⚠️ Cette étape redirige immédiatement tous les parents de l'établissement vers le système de paiement unifié : le paramètre de mode est partagé par toute l'école (voir l'avertissement en haut de la page) et il est impossible de tester le système de paiement unifié sans l'activer. Il est conseillé d'effectuer cette étape jusqu'à l'étape 5 en une seule fois, pendant une période de faible affluence.
Avant toute modification , ouvrez les paramètres de paiement de l'établissement dans l'interface d'administration OpenApply et notez la configuration actuelle du système de paiement hébergé (ID du marchand, ID du profil, clé d'accès, clé secrète) dans un endroit sûr, au cas où une restauration serait nécessaire ultérieurement :
Passez ensuite en mode Paiement unifié et saisissez les nouvelles valeurs :
- Identifiant du commerçant : même valeur qu’auparavant ; le compte du commerçant reste inchangé.
- Clé d'accès / Clé secrète : l'ID de clé et le secret partagé générés à l'étape 2 (ne réutilisez pas la clé d'accès/clé secrète de Hosted Checkout ; voir l'avertissement à l'étape 2).
- Notez que l'identifiant de profil disparaît dans ce mode : il s'agit d'un champ réservé à Hosted-Checkout, non utilisé par Unified Checkout.
- Environnement : sélectionnez Environnement en direct
- Vérifiez dès maintenant les transactions d'écran avec Decision Manager , si elles ont été incluses dans la demande de l'étape 1 et approuvées (faites-le avant l'étape 4 : l'abonnement au webhook est créé à partir de ce que cette case à cocher indique lors de la configuration).
Étape 4 : Configurer le webhook
Commencez par enregistrer la configuration Unified Checkout de l'étape 3. Une fois l'enregistrement effectué, accédez à l'écran des paramètres (voir la section Webhook Unified Checkout dans la capture d'écran ci-dessus) et cliquez sur « Configurer le webhook automatiquement » . Cette action génère et enregistre les identifiants webhook chiffrés, effectue une vérification de l'état du système et crée l'abonnement. Aucune intervention manuelle n'est requise dans Business Center.
Étape 5 : Validez avec une transaction réelle, puis maintenez la bascule ou annulez-la.
- Vérifiez que la nouvelle clé REST est enregistrée et que Decision Manager / 3DS / l'abonnement webhook sont tous actifs pour le MID de production.
- Effectuez une petite transaction réelle et vérifiez : l'autorisation réussit et le statut de la facturation/du débit est correctement mis à jour dans OpenApply
- Si tout est correct, la migration se fait sans modification : aucune action supplémentaire n’est requise, les parents paient désormais via le système de paiement unifié. En cas de problème, annulez immédiatement la migration.
Restauration : repassez en mode « Hébergement » et restaurez les identifiants sauvegardés à l’étape 3. Cette opération rétablit immédiatement le mode « Hébergement » pour tous les parents de l’établissement.