Qu'est-ce qu'une approbation de portefeuille ? Comment révoquer les autorisations de jetons ?

Définition de l'approbation du portefeuille

1. L'approbation du portefeuille fait référence au consentement explicite accordé par un utilisateur à une application ou à un service tiers pour accéder à des ressources ou fonctionnalités spécifiques au sein de son portefeuille numérique.

2. Ce processus se produit généralement via un flux d'autorisation OAuth 2.0 dans lequel l'utilisateur est redirigé vers une interface de portefeuille sécurisée et invité à confirmer les autorisations telles que l'affichage du solde, le lancement de transferts ou la gestion des informations d'identification stockées.

3. L'approbation génère un authCode et un authState , qui sont tous deux renvoyés au commerçant via un authRedirectUrl prédéfini.

4. Les étendues approuvées sont strictement appliquées : seules celles explicitement répertoriées lors de la demande d'autorisation peuvent être exercées par l'application client.

5. Chaque approbation est liée à un identifiant customerBelongsTo spécifique, garantissant l'isolement entre les différents écosystèmes de portefeuille comme Samsung Wallet, Apple Wallet ou Huawei Wallet Cloud.

Mécanisme de révocation des jetons

1. La révocation du jeton met fin aux privilèges de session active associés à un access_token ou à un rafraîchissement_token émis lors de l'autorisation du portefeuille.

2. Un client_id valide doit correspondre à celui utilisé dans la demande d'autorisation originale ; l’inclusion de l’ID d’équipe ou d’autres identifiants invalide la tentative de révocation.

3. La demande nécessite un client_secret signé au format JWT, généré à l'aide de la clé privée enregistrée sur le portail des développeurs du fournisseur de portefeuille.

4. Le paramètre token_type_hint permet d'optimiser la validation côté serveur mais n'est pas obligatoire : s'il est omis, le système effectue une détection interne du type de jeton.

5. Une révocation réussie renvoie HTTP 200 avec un corps JSON vide ; aucune autre action n'est requise du côté client une fois cette réponse reçue.

Flux d'acquisition de jetons d'accès

1. Les jetons d'accès servent d'informations d'identification de courte durée permettant des appels API authentifiés vers des services cloud de portefeuille tels que les systèmes backend Huawei Wallet Cloud ou Samsung Wallet.

2. Le point de terminaison d'acquisition de jetons utilise HTTPS POST avec le type de contenu application/x-www-form-urlencoded et impose grant_type=client_credentials .

3. Client_id et client_secret doivent être transmis sous forme de chaînes littérales entourées de guillemets doubles selon la spécification.

4. La réponse inclut access_token , token_type défini sur « Bearer » et facultatif expires_in indiquant la durée de vie en secondes.

5. Les jetons expirent après 3 600 secondes par défaut, sauf configuration contraire dans la console d'administration du fournisseur de portefeuille ou dans le tableau de bord d'intégration des partenaires.

Cycle de vie du modèle de notification

1. Les partenaires doivent enregistrer des modèles de messages via le portail des partenaires avant d'envoyer des notifications push aux titulaires de cartes portefeuille.

2. Les modèles sont soumis à une vérification automatisée des dommages pour détecter les expressions interdites, les résultats étant affichés comme Réussite ou Échec à côté du contenu signalé.

3. Les modèles rejetés déclenchent une notification par courrier électronique contenant les commentaires de l'administrateur ; les partenaires peuvent réviser et soumettre à nouveau après avoir résolu les problèmes cités.

4. Seules les notifications de type Merchant Push sont autorisées, le type de message étant limité aux catégories marketing ou autres.

5. La prise en charge multilingue nécessite des entrées de modèle distinctes pour chaque langue ajoutée dans les paramètres Informations générales.

Protocole de synchronisation de l'état de la carte

1. Samsung Wallet envoie des mises à jour d'état en temps réel, telles que AJOUTÉ, MISE À JOUR ou SUPPRIME, aux serveurs partenaires préconfigurés chaque fois que l'état de la carte change sur l'appareil d'un utilisateur.

2. Ces événements sont transmis via des rappels HTTPS de serveur à serveur à l'aide du point de terminaison de l'API Send Card State.

3. Les serveurs partenaires doivent être accessibles au public et capables de recevoir et d'analyser les charges utiles JSON contenant le cardId, l'état, l'horodatage et les métadonnées de l'appareil.

4. La vérification du statut d'émission de la carte nécessite que le modèle de carte portefeuille soit en statut VERIFYING ou ACTIVE avant le test.

5. L'intégration repose sur la réussite de l'intégration de Samsung Wallet, y compris la fourniture de certificats et la liste blanche des domaines.

Foire aux questions

Q : Un token révoqué peut-il être réutilisé après une réautorisation ? R : Non. Une fois révoqué, le jeton devient définitivement invalide, quelles que soient les tentatives d'autorisation ultérieures.

Q : La valeur authState doit-elle être cryptographiquement aléatoire ? R : Oui. Il doit s'agir d'une valeur unique et imprévisible générée par demande d'autorisation pour empêcher les attaques CSRF.

Q : Que se passe-t-il si authRedirectUrl contient des caractères spéciaux non codés ? R : Le serveur de portefeuille rejette la demande avec une erreur HTTP 400 en raison d'exigences de codage URI mal formées.

Q : La révocation du jeton affecte-t-elle les autres utilisateurs partageant le même client_id ? R : Non. La révocation fonctionne au niveau du jeton d'utilisateur individuel et n'a aucun impact sur les autorisations accordées aux autres utilisateurs.