Mettre à niveau REDA Pay

REDA Pay est un package géré : une nouvelle version s’installe par-dessus l’ancienne à l’aide d’un lien d’installation, et vos données, votre configuration et vos personnalisations sont conservées. Les mises à niveau sont courantes, mais trois choses qu’une mise à niveau gérée ne fait jamais surprennent les administrateurs à chaque fois : cet article est donc autant une liste de contrôle qu’une procédure.

Vérifier ce que vous avez

Configuration → Packages installés liste REDA Pay avec son Numéro de version. Les notes de version de ce portail indiquent la version qu’elles décrivent ; comparez avant de les lire.

Mettre d’abord à niveau une sandbox

1. Ouvrez le lien d’installation en étant connecté à la sandbox (ou choisissez la connexion à la sandbox lorsque le lien le demande).
2. Choisissez qui reçoit l’accès aux composants du package. Install for Admins Only (installer pour les administrateurs uniquement) est le choix sûr par défaut : l’accès est accordé par les ensembles d’autorisations REDA Pay, pas par le choix fait à l’installation.
3. Cliquez sur Upgrade (mettre à niveau) et attendez l’e-mail de confirmation.
4. Effectuez les vérifications des sections suivantes, encaissez un paiement de test dans l’environnement de test de Payload, et seulement ensuite recommencez en production.

Les trois choses qu’une mise à niveau ne fait jamais

Une mise à niveau gérée installe les nouveaux composants mais ne touche pas à ce que vous avez pu personnaliser. Pour chaque nouveau champ ou valeur listé dans une note de version, faites ceci à la main :

1. Placer les nouveaux champs dans vos présentations de page

Si vous avez déjà modifié une présentation de page REDA Pay (et la plupart des organisations l’ont fait), un nouveau champ est installé mais n’est pas placé dans votre présentation. Seules les présentations intactes, celles du package par défaut, le reçoivent. Pour chaque nouveau champ listé dans la note de version : Configuration → Gestionnaire d’objet → l’objet → Présentations de page → votre présentation, faites glisser le champ dans la section indiquée par la note, puis cliquez sur Enregistrer.

2. Accorder la sécurité au niveau du champ à vos propres ensembles d’autorisations et profils

Le package accorde les nouveaux champs à ses propres ensembles d’autorisations. Si vos utilisateurs ont vos propres ensembles d’autorisations ou profils au lieu de ceux de REDA Pay, ou en plus, ils n’ont aucun accès au nouveau champ tant que vous ne l’accordez pas : Configuration → Gestionnaire d’objet → l’objet → Champs et relations → le champ → Définir la sécurité au niveau du champ, puis cochez la visibilité (et la lecture seule le cas échéant) pour chaque profil ou ensemble d’autorisations.

Testez avec un utilisateur ordinaire du rôle concerné, jamais en tant qu’administrateur : les administrateurs voient les champs quelle que soit la sécurité au niveau du champ, donc tester avec votre propre utilisateur ne prouve rien.

3. Ajouter à la main les nouvelles valeurs de liste de sélection

Une mise à niveau n’ajoute jamais de nouvelle valeur de liste de sélection à un champ que votre organisation possède déjà. Les nouvelles installations la reçoivent ; les organisations mises à niveau non, même lorsqu’un nouveau champ arrive dans la même version. Si une note de version liste une nouvelle valeur, ajoutez-la avec l’orthographe exacte : Configuration → Gestionnaire d’objet → l’objet → Champs et relations → le champ → Nouveau → la valeur → Enregistrer, puis réordonnez-la. Sur une liste de sélection restreinte, une valeur manquante fait échouer la fonctionnalité, au lieu de simplement masquer une option.

Là où se trouve votre version. Comparez-la avec les notes de version avant de les lire.

Lire une note de version

Chaque note de version REDA Pay de ce portail indique, pour chaque changement, les étapes à réaliser dans votre organisation. Lisez-la en gardant les trois règles ci-dessus à l’esprit :

Script de test en sandbox

Exécutez ceci dans la sandbox après la mise à niveau, avec un utilisateur qui n’a que l’ensemble d’autorisations REDA Pay du rôle concerné :

1. Ouvrez une piste et appuyez sur le bouton Pay ; l’écran s’ouvre avec le logo et les onglets.
2. Encaissez un paiement bancaire de 1 $ dans l’environnement de test de Payload ; l’ordre affiche Immediate - Processed.
3. Ouvrez la Pay Transaction et appuyez sur Sync Transaction ; l’opération se termine.
4. Créez puis annulez une planification ; créez un lien, ouvrez-le dans une fenêtre privée, révoquez-le.
5. En tant qu’utilisateur du portail, ouvrez la page de paiement du portail et atteignez l’écran de paiement.
6. En tant qu’administrateur, ouvrez le Pay Profile : Webhook Setup liste dix lignes ; appuyez sur Sync Processing Accounts ; l’opération réussit.
7. Vérifiez s’il y a du nouveau dans les REDA Pay Logs.

Si une étape échoue dans la sandbox, arrêtez-vous et contactez support@reda.one en indiquant l’étape et le message avant de toucher à la production.

Prévenir vos utilisateurs

Une mise à niveau change rarement ce que voit le personnel, mais lorsqu’une version ajoute un bouton, un champ ou un écran, prévenez les personnes qui l’utiliseront avant qu’elles ne le découvrent. La section « ce que vous verrez » de la note de version est rédigée pour être transmise.

Ce qui survit à une mise à niveau, et ce qu’il faut revérifier

Après la mise à niveau : une vérification de dix minutes

1. Packages installés affiche la nouvelle version.
2. Onglet REDA Pay Admin : clé Generated, commutateur de la tâche de récupération sur Yes.
3. Encaissez un paiement de test en tant que collaborateur et, si vous en avez, en tant qu’utilisateur du portail et via un lien.
4. Ouvrez un Pay Order et une Pay Transaction en tant que non-administrateur : chaque champ ajouté par la note de version est visible.
5. REDA Pay Logs : aucune nouvelle entrée Attention Needed.

Erreurs à éviter

Questions fréquentes

Pour aller plus loin

• Qui peut faire quoi : ensembles d’autorisations
• Feuille de route de configuration