Aller au contenu principal

Supprimer un utilisateur

Supprime l’utilisateur authentifié dans le périmètre réseau de son jeton d’accès utilisateur.

Domaine
Users and identity
Service responsable
Merchant management
Destiné à
Application client · utilisateur vers serveur
Autorisation prise en charge
Jeton Bearer de l’utilisateur authentifié

En-têtes#

3
AuthorizationstringObligatoire
Accepté ou transféré par l’API Gateway pour cette opération.
X-Device-IdstringFacultatif
Accepté ou transféré par l’API Gateway pour cette opération.
X-Merchant-IdstringFacultatif
Accepté ou transféré par l’API Gateway pour cette opération.

Paramètres de chemin#

1
user_idstring<uuid>Obligatoire
Valeur qui remplace `user_id` dans le chemin de l’endpoint.

Corps de la requête#

0
Cet endpoint n’accepte pas de corps de requête.

Réponse#

6
204La requête a été acceptée ou terminée. Consultez le payload pour le résultat métier.
400La requête est incorrecte ou échoue à la validation.
401Les identifiants ou le contexte de l’appelant sont incorrects.
404La ressource ou la route demandée est introuvable.
500Le service n’a pas pu traiter la requête. Réessayez uniquement si l’opération est sûre ou idempotente.
503Le service n’a pas pu traiter la requête. Réessayez uniquement si l’opération est sûre ou idempotente.

Avant de supprimer un utilisateur#

  • Obtenez le jeton d’accès utilisateur du client au moyen du flux d’authentification.
  • Définissez l’ID utilisateur du chemin avec l’UUID du client authentifié. Un client ne peut supprimer que son propre utilisateur.
  • Confirmez que le client souhaite supprimer son compte du réseau associé à ce jeton.

Comprendre le périmètre de suppression#

Avec un jeton limité à un réseau, la suppression retire l’appartenance de l’utilisateur et ses adresses dans ce réseau, et demande la suppression de ses cartes dans le même réseau. Elle n’implique pas une suppression de tous les réseaux DEUNA. Un jeton de compte couvrant l’ensemble de DEUNA supprime également le compte et ses appartenances réseau. Une suppression réussie supprime les sessions actives de l’utilisateur.

Ne considérez pas cette opération comme une confirmation de l’effacement de tous les historiques de paiement ou de toutes les données personnelles. Confirmez le périmètre de suppression du compte et des données avec votre Technical Account Manager DEUNA avant de créer un flux de clôture de compte.

Envoyer la demande de suppression#

Utilisez l’URL de base sandbox ci-dessous pour les tests et https://api.deuna.io pour la production. Envoyez le jeton Bearer du client dans l’en-tête Authorization. L’endpoint n’a ni paramètres de requête ni corps de requête.

curl --request DELETE \
  --url 'https://api.sandbox.deuna.io/users/USER_ID' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN'

Vérifier le résultat#

Une requête réussie renvoie HTTP 204 No Content avec un corps vide. Effacez la session locale du client et affichez votre expérience déconnectée. N’interprétez pas la réponse comme du JSON et n’attendez pas de webhook de paiement pour confirmer cette opération.

Gérer les erreurs et les résultats incertains#

HTTP 400 peut indiquer que l’utilisateur du chemin diffère de celui du jeton. HTTP 401 signifie que le jeton utilisateur ne peut pas autoriser la requête ; HTTP 404 signifie que l’enregistrement demandé est introuvable. Corrigez la requête ou l’authentification avant de réessayer.

Un délai d’attente dépassé ou une erreur serveur peut survenir après l’exécution d’une partie de la suppression. HTTP 503 peut survenir pendant le nettoyage des sessions après la suppression. Ne supposez pas qu’une nouvelle tentative renverra la même réponse et ne répétez pas automatiquement la requête. Vérifiez l’état du compte avec le support DEUNA lorsque le résultat est incertain. Aucun contrat de clé d’idempotence n’est défini pour cette opération.

Voir codes de réponse et le dépannage pour des conseils généraux sur la gestion des erreurs.