Aller au contenu principal

Actualiser le CVV

Envoyez une nouvelle valeur de vérification de carte pour une carte enregistrée appartenant à l’utilisateur authentifié.

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_idstring<uuid>Obligatoire
Valeur qui remplace `user_id` dans le chemin de l’endpoint.
card_idstring<uuid>Obligatoire
Valeur qui remplace `card_id` dans le chemin de l’endpoint.

Corps de la requête#

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

Réponse#

7
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.
403Les identifiants ou le contexte de l’appelant sont incorrects.
404La ressource ou la route demandée est introuvable.
422La requête est incorrecte ou échoue à la validation.
500Le service n’a pas pu traiter la requête. Réessayez uniquement si l’opération est sûre ou idempotente.

Avant d’actualiser le CVV#

  • Authentifiez le client et envoyez son jeton d’accès utilisateur dans l’en-tête Authorization.
  • Définissez l’ID utilisateur du chemin avec l’UUID du client authentifié et utilisez un ID de carte renvoyé par Lister les cartes enregistrées.
  • Demandez au client la valeur de vérification de carte (CVV) de la carte enregistrée. La carte doit appartenir à ce client et avoir une date d’expiration valide.

Envoyer la demande d’actualisation#

Utilisez l’URL de base sandbox ci-dessous pour les tests et https://api.deuna.io pour la production. Envoyez un objet JSON avec la chaîne obligatoire card_cvv contenant le CVV de trois ou quatre chiffres. Il n’y a pas de paramètres de requête. Cette opération met à jour une carte existante ; elle ne crée pas de carte et ne débite pas le client.

curl --request POST \
  --url 'https://api.sandbox.deuna.io/users/USER_ID/cards/CARD_ID/refresh-cvv' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"card_cvv":"123"}'

Vérifier le résultat#

Une requête réussie renvoie HTTP 204 No Content avec un corps vide. Ne l’interprétez pas comme du JSON. La réponse confirme la fin de l’actualisation du CVV ; elle ne confirme pas un paiement et n’expose pas le CVV dans une réponse de carte. Aucun webhook de paiement n’est nécessaire pour confirmer cette opération.

Poursuivez avec votre requête de paiement lorsque le client est prêt à payer.

Gérer les erreurs et les nouvelles tentatives#

HTTP 400 indique des identifiants invalides, un JSON mal formé ou un CVV manquant ou invalide. HTTP 401 indique une autorisation utilisateur invalide. HTTP 404 signifie que la carte enregistrée est introuvable pour l’utilisateur authentifié. HTTP 422 indique une carte expirée, des données d’expiration invalides ou une carte dont le CVV ne peut pas être actualisé. Corrigez les données ou sélectionnez une autre carte avant de réessayer.

Si un délai d’attente dépassé ou une erreur serveur rend le résultat incertain, ne renvoyez pas automatiquement le CVV. Aucun contrat de clé d’idempotence n’est défini pour cette opération. Laissez le client réessayer dans le flux actif et demandez à nouveau le CVV si nécessaire. Consultez les codes de réponse et le dépannage.