Passa al contenuto principale
Tutti i sistemi operativiNovitàv1
Accedi
PATCHhttps://api.sandbox.deuna.io/users/{user_id}/cards/{card_id}/set-as-default

Impostare una carta come predefinita

Imposta una carta salvata come carta di pagamento predefinita dell’utente autenticato oppure rimuovine lo stato predefinito.

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_idstringObbligatorio
Valore che sostituisce `user_id` nel percorso dell’endpoint.
card_idstringObbligatorio
Valore che sostituisce `card_id` nel percorso dell’endpoint.

Corpo della richiesta#

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

Risposta#

4
200La richiesta è stata accettata o completata. Controlla il payload per l’esito operativo.
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.

Comportamento della carta predefinita#

Invia {"is_default": true} per rendere la carta salvata selezionata quella predefinita dell’utente. DEUNA rimuove lo stato predefinito da ogni altra carta dello stesso utente, così che esista al massimo una carta predefinita.

Il corpo della richiesta è facoltativo. Ometterlo ha lo stesso effetto dell’invio di {"is_default": true}. Invia {"is_default": false} per rimuovere lo stato predefinito dalla carta selezionata senza modificare le altre carte.

Prima di chiamare l’endpoint#

  • Autentica il cliente e invia il relativo token di accesso utente nell’ Authorization header.
  • Imposta user_id con l’UUID dell’utente autenticato.
  • Usa un card_id restituito da Elencare le carte memorizzate. La carta deve appartenere all’utente autenticato.

Verifica il risultato#

Una richiesta riuscita restituisce 200 OK con la carta aggiornata. Verifica che il campo is_default corrisponda al valore richiesto. Puoi anche elencare le carte salvate dell’utente e verificare che nessun’altra sia contrassegnata come predefinita.

L’endpoint restituisce 404 Not Found quando la carta selezionata non esiste per l’utente autenticato. Correggi gli UUID non validi o il JSON non valido prima di riprovare; le richieste ripetute con lo stesso is_default lasciano la carta nello stesso stato.