Passa al contenuto principale

Aggiornare il CVV

Invia un nuovo valore di verifica della carta per una carta salvata appartenente all’utente autenticato.

Dominio
Cards and vault
Servizio responsabile
Payments
Destinato a
Applicazione cliente · utente verso server
Autorizzazione supportata
Token Bearer dell’utente autenticato

Header#

2
AuthorizationstringObbligatorio
Accettato o inoltrato dall’API Gateway per questa operazione.
X-Merchant-IDstringFacoltativo
Accettato o inoltrato dall’API Gateway per questa operazione.

Parametri del percorso#

2
user_idstring<uuid>Obbligatorio
Valore che sostituisce `user_id` nel percorso dell’endpoint.
card_idstring<uuid>Obbligatorio
Valore che sostituisce `card_id` nel percorso dell’endpoint.

Corpo della richiesta#

1
card_cvvstringObbligatorio
Payload JSON accettato dal servizio responsabile. Usa il pannello della richiesta per modificarlo e visualizzarne l’anteprima.
Esempio 123

Risposta#

7
204La richiesta è stata accettata o completata. Controlla il payload per l’esito operativo.
400La richiesta non è valida o non supera la convalida.
401Le credenziali o il contesto del chiamante non sono validi.
403Le credenziali o il contesto del chiamante non sono validi.
404La risorsa o la route richiesta non è stata trovata.
422La richiesta non è valida o non supera la convalida.
500Il servizio non ha completato la richiesta. Riprova solo se l’operazione è sicura o idempotente.

Prima di aggiornare il CVV#

  • Autentica il cliente e invia il suo token di accesso utente nell’header Authorization.
  • Imposta l’ID utente del percorso con l’UUID del cliente autenticato e usa un ID carta restituito da Elencare le carte memorizzate.
  • Richiedi al cliente il valore di verifica della carta (CVV) per la carta salvata. La carta deve appartenere a quel cliente e avere una data di scadenza valida.

Inviare la richiesta di aggiornamento#

Usa l’URL di base sandbox qui sotto per i test e https://api.deuna.io per la produzione. Invia un oggetto JSON con la stringa obbligatoria card_cvv contenente il CVV di tre o quattro cifre. Non sono previsti parametri di query. Questa operazione aggiorna una carta esistente; non crea una carta e non addebita il cliente.

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"}'

Verifica il risultato#

Una richiesta riuscita restituisce HTTP 204 No Content con un corpo vuoto. Non interpretarlo come JSON. La risposta conferma il completamento dell’aggiornamento del CVV; non conferma un pagamento né espone il CVV in una risposta relativa alla carta. Non serve un webhook di pagamento per confermare questa operazione.

Prosegui con la tua richiesta di pagamento quando il cliente è pronto a pagare.

Gestire errori e nuovi tentativi#

HTTP 400 indica identificatori non validi, JSON non valido o un CVV mancante o non valido. HTTP 401 indica un’autorizzazione utente non valida. HTTP 404 significa che la carta salvata non è stata trovata per l’utente autenticato. HTTP 422 indica una carta scaduta, dati di scadenza non validi o una carta il cui CVV non può essere aggiornato. Correggi i dati o seleziona un’altra carta prima di riprovare.

Se un timeout o un errore del server lascia l’esito incerto, non inviare nuovamente il CVV in automatico. Per questa operazione non è definito un contratto di chiave di idempotenza. Consenti al cliente di riprovare nel flusso attivo e richiedi nuovamente il CVV quando necessario. Consulta codici di risposta e risoluzione dei problemi.