Saltar al contingut principal
POST
L’autenticació és una funcionalitat nova. Aquests endpoints els serveix l’emissor de la teva aplicació, com ara https://<name>.auth.didit.me, i mai no reben la teva clau d’API de Didit.
Els paràmetres de consulta step_up i status del teu return_to només indiquen a la teva aplicació que ho ha de consultar. Abans d’actuar, consulta el pas d’autenticació reforçada amb Obtén un pas d’autenticació reforçada i continua només quan status sigui approved.

Autoritzacions

Authorization
string
header
requerit

El token d'accés de la persona procedent de POST /token/: un JWT ES256 amb la capçalera typ: at+jwt, vàlid durant un màxim de 5 minuts. No és la teva clau d'API de Didit.

Cos

application/json

L'acció sensible que la persona està a punt de dur a terme.

action
enum<string>
requerit

payout (una retirada o transferència), bank (afegir o canviar un compte bancari) o contact (canviar un correu electrònic o número de telèfon). Una retirada també aplica la regla del dispositiu nou.

Opcions disponibles:
payout,
bank,
contact
return_to
string
requerit

On torna la persona després de verificar-se, amb step_up=<id>&status=approved afegit. Quan s'aplica una regla, ha de ser un dels URI de redirecció de l'aplicació; quan no se n'aplica cap, no es comprova.

Maximum string length: 2048
Exemple:

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

amount
string

Obligatori per a payout: l'import, fins a dos decimals. També s'accepta un número JSON.

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

"900.00"

currency
string

Codi ISO 4217 de amount. El valor per defecte és la moneda de la regla de pagament; un pagament en una altra moneda sempre es comprova.

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

"USD"

Resposta

Cap regla no és aplicable.

Cap regla no és aplicable: continua amb l'acció.

required
enum<boolean>
requerit
Opcions disponibles:
false
Darrera modificació el 7 de novembre del 2026