Passer au contenu principal
POST
L’authentification est nouvelle. Ces endpoints sont servis par l’émetteur de votre application, par exemple https://<name>.auth.didit.me, et n’acceptent jamais votre clé API Didit.
Les paramètres de requête step_up et status présents dans votre return_to indiquent seulement à votre application de vérifier. Avant d’agir, lisez le step-up avec Obtenir un step-up et ne poursuivez que si status vaut approved.

Autorisations

Authorization
string
header
requis

Le token d'accès de la personne issu de POST /token/ : un JWT ES256 avec l'en-tête typ: at+jwt, valide pendant au plus 5 minutes. Il ne s'agit pas de votre clé API Didit.

Corps

application/json

L'action sensible que la personne est sur le point d'effectuer.

action
enum<string>
requis

payout (un retrait ou un virement), bank (l'ajout ou la modification d'un compte bancaire) ou contact (la modification d'une adresse e-mail ou d'un numéro de téléphone). Un retrait ou un virement applique également la règle du nouvel appareil.

Options disponibles:
payout,
bank,
contact
return_to
string
requis

Emplacement où la personne est redirigée après la vérification, avec step_up=<id>&status=approved ajouté. Lorsqu'une règle s'applique, il doit s'agir de l'un des URI de redirection de l'application ; si aucune règle ne s'applique, il n'est pas vérifié.

Maximum string length: 2048
Exemple:

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

amount
string

Requis pour payout : le montant, jusqu'à deux décimales. Un nombre JSON est également accepté.

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

"900.00"

currency
string

Code ISO 4217 de amount. La valeur par défaut est la devise de la règle de versement ; un versement dans une autre devise est toujours vérifié.

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

"USD"

Réponse

Aucune règle ne s'applique.

Aucune règle ne s'applique : poursuivez l'action.

required
enum<boolean>
requis
Options disponibles:
false
Dernière modification le 7 novembre 2026