Vai al contenuto principale
POST
L’autenticazione è una novità. Questi endpoint sono serviti dall’emittente della tua applicazione, come https://<name>.auth.didit.me, e non accettano mai la tua chiave API Didit.
I parametri di query step_up e status nel tuo return_to servono solo a indicare alla tua applicazione di verificare. Prima di agire, leggi lo step-up con Ottieni uno step-up e prosegui solo se status è approved.

Autorizzazioni

Authorization
string
header
obbligatorio

Il token di accesso della persona restituito da POST /token/: un JWT ES256 con intestazione typ: at+jwt, valido per un massimo di 5 minuti. Non la tua chiave API di Didit.

Corpo

application/json

L'azione sensibile che la persona sta per compiere.

action
enum<string>
obbligatorio

payout (un prelievo o un trasferimento), bank (aggiunta o modifica di un conto bancario) o contact (modifica di un'email o di un numero di telefono). Un payout applica anche la regola del nuovo dispositivo.

Opzioni disponibili:
payout,
bank,
contact
return_to
string
obbligatorio

Dove ritorna la persona dopo la verifica, con l'aggiunta di step_up=<id>&status=approved. Quando si applica una regola, deve essere uno degli URI di reindirizzamento dell'applicazione; quando non se ne applica nessuna, non viene verificato.

Maximum string length: 2048
Esempio:

"https://app.example.com/payouts/confirm"

amount
string

Obbligatorio per payout: l'importo, fino a due cifre decimali. È accettato anche un numero JSON.

Pattern: ^[0-9]{1,16}(\.[0-9]{1,2})?$
Esempio:

"900.00"

currency
string

Codice ISO 4217 di amount. Il valore predefinito corrisponde alla valuta della regola di pagamento; un pagamento in un'altra valuta viene sempre verificato.

Pattern: ^[A-Z]{3}$
Esempio:

"USD"

Risposta

Nessuna regola applicabile.

Nessuna regola applicabile: procedi con l'azione.

required
enum<boolean>
obbligatorio
Opzioni disponibili:
false
Ultima modifica il 7 novembre 2026