Comprendre les appels de maintenance, les redémarrages automatiques, les changements de configuration et les mises à jour logicielles.
Afin de garantir que vos terminaux continuent de fonctionner correctement et utilisent des paramètres et des logiciels à jour, plusieurs opérations se produisent automatiquement sur les terminaux :
Appels de maintenance : toutes les quelques heures, le terminal contacte notre plateforme pour vérifier les changements de configuration et les mises à jour logicielles. Le terminal n’applique ou n’installe encore rien (à quelques exceptions près).
Redémarrage : pour des raisons de sécurité, le terminal doit vider régulièrement son cache. Pour ce faire, le terminal redémarre une fois toutes les 24 heures à l’heure de redémarrage.
Changements de configuration : tous les changements de configuration détectés par le terminal lors d’un appel de maintenance sont appliqués lorsque le terminal redémarre à l’heure de redémarrage.
Mises à jour logicielles : si le terminal est configuré pour se mettre à jour automatiquement, toute mise à jour logicielle détectée lors d’un appel de maintenance est installée lorsque le terminal redémarre à l’heure de redémarrage.
Ces événements n’interfèrent pas avec l’acceptation des paiements ou les opérations quotidiennes. Ci-dessous, nous expliquons ces événements plus en détail et décrivons ce que vous devez faire.
Appels de maintenance
Chaque jour, le terminal contacte notre plateforme à plusieurs reprises pour vérifier les mises à jour. Nous appelons cela des appels de maintenance. Lors d’un appel de maintenance, le terminal est informé de tout changement de configuration, par exemple les paramètres du terminal configurés dans votre Customer Area. Si le terminal est configuré pour se mettre à jour automatiquement, il est également informé des mises à jour logicielles disponibles.
Vous ne remarquerez pas ces appels de maintenance, car :
• En moyenne, un appel de maintenance ne prend que 1,8 seconde.
• Les changements et mises à jour logicielles ne sont pas installés immédiatement, à quelques exceptions près.
• Le terminal n’effectue pas d’appel de maintenance lorsqu’il traite un paiement ou une autre opération.
Les terminaux sont programmés pour effectuer des appels de maintenance régulièrement — par défaut toutes les trois heures. Cette période est appelée intervalle de maintenance. Si le terminal est occupé au moment prévu, il attend une minute et réessaie jusqu’à ce qu’un appel de maintenance réussisse. Une fois l’appel effectué, le terminal attend le prochain appel planifié.
Redémarrage à l’heure de redémarrage
Le redémarrage signifie que le terminal est mis hors tension puis rallumé. Le logiciel redémarre ensuite. Ce processus prend environ deux minutes. Le cycle d’alimentation permet de vider le cache du terminal, ce qui est important pour des raisons de sécurité.
Lors du redémarrage, le terminal installe également tous les changements de configuration ou mises à jour logicielles détectés lors d’un appel de maintenance. L’installation du logiciel peut prendre jusqu’à 30 minutes.
Afin de garantir un nettoyage régulier du cache et des mises à jour fréquentes, le terminal est programmé pour redémarrer une fois toutes les 24 heures, à l’heure dite de redémarrage. Par défaut, cette heure est fixée à 6 h 00 dans le fuseau horaire du terminal.
Définir l’heure de redémarrage
Pour vous assurer que le terminal redémarre pendant une période d’inactivité, vous pouvez modifier l’heure de redémarrage dans votre Customer Area. Les éléments à considérer incluent :
• Vos heures d’ouverture
• Les événements opérationnels
Pour cette action, vous devez être utilisateur administrateur.
Pour modifier l’heure de redémarrage :
Connectez-vous à votre Customer Area.
Sélectionnez éventuellement le compte commerçant, le magasin ou le terminal concerné.
Allez dans Paiements en personne > Paramètres du terminal > Matériel.
Dans la section Maintenance, sélectionnez une valeur pour l’heure de redémarrage.
En bas de la page, cliquez sur Enregistrer.
Changements de configuration
Les changements de configuration peuvent provenir de paramètres modifiés dans votre Customer Area, de requêtes API ou de mises à jour globales initiées par Adyen (par exemple une mise à jour des limites CVM sans contact). Ces changements sont appliqués lors du redémarrage de l’application Adyen, soit à l’heure de redémarrage, soit lors d’un redémarrage manuel.
Mise à jour de la configuration à l’heure de redémarrage
Le terminal reçoit les changements de configuration lors d’un appel de maintenance, puis les applique lorsque l’application Adyen redémarre à l’heure programmée. Il existe quelques exceptions :
• Les changements critiques initiés par Adyen qui doivent être appliqués rapidement. Dans ce cas, une instruction est envoyée pour redémarrer immédiatement après l’appel de maintenance (environ 30 secondes).
• L’installation ou la suppression d’applications Android sur les terminaux Android, qui s’effectuent immédiatement.
• La mise à jour manuelle de la configuration directement sur le terminal.
Mettre à jour la configuration manuellement
Si vous souhaitez appliquer immédiatement les changements :
Sur le terminal, ouvrez le menu Admin.
Sélectionnez Config > Mettre à jour.
Le terminal récupère la configuration mise à jour, puis redémarre.
Mise à jour automatique de la configuration
Vous pouvez activer un paramètre permettant de redémarrer automatiquement l’application Adyen dès qu’une configuration est mise à jour. Cela permet d’appliquer les changements sans redémarrer les autres applications installées sur le terminal, ce qui est utile pour les terminaux sans surveillance (distributeurs automatiques, bornes, systèmes de stationnement, etc.).
Pour activer la mise à jour automatique :
Effectuez une requête PATCH vers l’endpoint /terminalSettings pour le compte entreprise, commerçant, magasin ou terminal, en incluant l’objet terminalInstructions avec :
• adyenAppRestart (booléen) : indique si l’application Adyen redémarre automatiquement après une mise à jour de configuration.
Exemple :
curl https://management-test.adyen.com/v3/companies/{companyId}/terminalSettings \ -H 'x-API-key: ADYEN_API_KEY' \ -X PATCH \ -d '{ "terminalInstructions" : { "adyenAppRestart" : true }}'La réponse renvoie tous les paramètres du terminal au niveau où la requête a été effectuée.
Mises à jour logicielles
Par défaut, le logiciel Adyen du terminal est mis à jour automatiquement. Lorsqu’une nouvelle version est disponible, le terminal en est informé lors d’un appel de maintenance. Lors du redémarrage à l’heure programmée, il télécharge et installe la mise à jour.
Le téléchargement en arrière-plan peut également être activé (activé par défaut sur les terminaux Android). Cela réduit le risque d’échec dû à une perte de connexion au moment du redémarrage.
Vous pouvez également choisir de participer au programme bêta.
Pour plus d’informations sur les stratégies de mise à jour et le cycle de publication, consultez la section Mettre à jour vers une nouvelle version.
Ce que vous devez faire
Il est important de s’assurer que :
• Le terminal effectue au moins un appel de maintenance par jour. Pour cela, il doit être allumé et connecté au réseau.
• Le terminal redémarre chaque jour. Pour un redémarrage automatique, il doit être allumé à l’heure programmée et connecté au réseau afin de télécharger les mises à jour.
Cela signifie que votre terminal doit être allumé et connecté au réseau pendant au moins un intervalle de maintenance (trois heures) avant l’heure de redémarrage (6 h 00 par défaut).
En pratique, nous recommandons de laisser vos terminaux allumés et connectés au réseau pendant la nuit.