Saltar al contenido principal
POST
La autenticación es nueva. Estos endpoints los sirve el emisor de tu aplicación, como https://<name>.auth.didit.me, y nunca reciben tu clave de API de Didit.
Los parámetros de consulta step_up y status de tu return_to solo le indican a tu aplicación que debe comprobarlo. Antes de actuar, lee el step-up con Obtener un step-up y continúa solo cuando status sea approved.

Autorizaciones

Authorization
string
header
requerido

El token de acceso de la persona obtenido de POST /token/: un JWT ES256 con el encabezado typ: at+jwt, válido durante un máximo de 5 minutos. No es tu clave de API de Didit.

Cuerpo

application/json

La acción sensible que la persona está a punto de realizar.

action
enum<string>
requerido

payout (un retiro o una transferencia), bank (añadir o cambiar una cuenta bancaria) o contact (cambiar un correo electrónico o un número de teléfono). Un pago saliente también aplica la regla de dispositivo nuevo.

Opciones disponibles:
payout,
bank,
contact
return_to
string
requerido

Dirección a la que vuelve la persona después de verificarse, con step_up=<id>&status=approved añadido. Cuando se aplica una regla, debe ser uno de los URI de redirección de la aplicación; cuando no se aplica ninguna, no se comprueba.

Maximum string length: 2048
Ejemplo:

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

amount
string

Obligatorio para payout: el importe, con hasta dos decimales. También se acepta un número JSON.

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

"900.00"

currency
string

Código ISO 4217 de amount. El valor predeterminado es la moneda de la regla de pagos; un pago en otra moneda siempre se comprueba.

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

"USD"

Respuesta

No se aplica ninguna regla.

No se aplica ninguna regla: continúa con la acción.

required
enum<boolean>
requerido
Opciones disponibles:
false
Última modificación el 1 de noviembre de 2026