Actualiser le CVV
Envoyez une nouvelle valeur de vérification de carte pour une carte enregistrée appartenant à l’utilisateur authentifié.
En-têtes#
2Paramètres de chemin#
2Corps de la requête#
1123Réponse#
7Avant 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"}'const response = await fetch("https://api.sandbox.deuna.io/users/USER_ID/cards/CARD_ID/refresh-cvv", {
method: "POST",
headers: {
"Authorization": "Bearer USER_ACCESS_TOKEN",
"Content-Type": "application/json"
},
body: JSON.stringify({
"card_cvv": "123"
})
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();import requests
response = requests.request(
"POST",
"https://api.sandbox.deuna.io/users/USER_ID/cards/CARD_ID/refresh-cvv",
headers={
"Authorization": "Bearer USER_ACCESS_TOKEN",
"Content-Type": "application/json"
},
json={
"card_cvv": "123"
},
)
response.raise_for_status()
data = response.json()<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sandbox.deuna.io/users/USER_ID/cards/CARD_ID/refresh-cvv",
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer USER_ACCESS_TOKEN",
"Content-Type: application/json"
],
CURLOPT_POSTFIELDS => json_encode([
"card_cvv" => "123"
])
]);
$response = curl_exec($curl);
curl_close($curl);import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Example {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.sandbox.deuna.io/users/USER_ID/cards/CARD_ID/refresh-cvv"))
.header("Authorization", "Bearer USER_ACCESS_TOKEN")
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString("{\"card_cvv\":\"123\"}"))
.build();
HttpResponse<String> response = HttpClient.newHttpClient().send(
request, HttpResponse.BodyHandlers.ofString()
);
System.out.println(response.body());
}
}package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
request, err := http.NewRequest("POST", "https://api.sandbox.deuna.io/users/USER_ID/cards/CARD_ID/refresh-cvv", strings.NewReader("{\"card_cvv\":\"123\"}"))
if err != nil { panic(err) }
request.Header.Set("Authorization", "Bearer USER_ACCESS_TOKEN")
request.Header.Set("Content-Type", "application/json")
response, err := http.DefaultClient.Do(request)
if err != nil { panic(err) }
defer response.Body.Close()
body, _ := io.ReadAll(response.Body)
fmt.Println(string(body))
}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.
Cette page vous a-t-elle été utile ?