Aller au contenu principal
Tous les systèmes sont opérationnelsNouveautésv1
Se connecter
PATCHhttps://api.sandbox.deuna.io/users/{user_id}/cards/{card_id}/set-as-default

Définir une carte par défaut

Définissez une carte enregistrée comme carte de paiement par défaut de l’utilisateur authentifié ou retirez-lui ce statut.

Domaine
Cards and vault
Service responsable
Payments
Destiné à
Application client · utilisateur vers serveur
Autorisation prise en charge
Jeton Bearer de l’utilisateur authentifié

En-têtes#

2
AuthorizationstringObligatoire
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#

2
user_idstringObligatoire
Valeur qui remplace `user_id` dans le chemin de l’endpoint.
card_idstringObligatoire
Valeur qui remplace `card_id` dans le chemin de l’endpoint.

Corps de la requête#

1
is_defaultbooleanFacultatif
Payload JSON accepté par le service responsable. Utilisez le panneau de requête pour le modifier et le prévisualiser.
Exemple true

Réponse#

4
200La requête a été acceptée ou terminée. Consultez le payload pour le résultat métier.
401Les identifiants ou le contexte de l’appelant sont incorrects.
403Les identifiants ou le contexte de l’appelant sont incorrects.
404La ressource ou la route demandée est introuvable.

Comportement de la carte par défaut#

Envoyer {"is_default": true} pour faire de la carte enregistrée sélectionnée la carte par défaut de l’utilisateur. DEUNA retire ce statut aux autres cartes du même utilisateur, afin qu’il n’existe au maximum qu’une seule carte par défaut.

Le corps de la requête est facultatif. L’omettre produit le même effet que l’envoi de {"is_default": true}. Envoyer {"is_default": false} pour retirer le statut par défaut de la carte sélectionnée sans modifier les autres cartes.

Avant d’appeler l’endpoint#

  • Authentifiez le client et envoyez son jeton d’accès utilisateur dans le Authorization header.
  • Renseignez user_id avec l’UUID de l’utilisateur authentifié.
  • Utilisez un card_id renvoyé par Lister les cartes enregistrées. La carte doit appartenir à l’utilisateur authentifié.

Vérifier le résultat#

Une requête réussie renvoie 200 OK avec la carte mise à jour. Vérifiez que son champ is_default correspond à la valeur demandée. Vous pouvez également lister les cartes enregistrées de l’utilisateur et vérifier qu’aucune autre n’est marquée comme carte par défaut.

L’endpoint renvoie 404 Not Found lorsque la carte sélectionnée n’existe pas pour l’utilisateur authentifié. Corrigez les UUID non valides ou le JSON mal formé avant de réessayer ; des requêtes répétées avec la même is_default laissent la carte dans le même état.