Saltar al contenido principal
POST
Refresh status
Use esta operación para un caso de incorporación existente. Se requieren customerId y caseId. El caso debe pertenecer al cliente y a la empresa autenticada.

Verificación antes de renovar

Envíe un objeto JSON vacío para el flujo normal. force vale false por defecto. Si el proveedor no devuelve una actualización, la renovación requiere refresh_provider_steps en availableActions. Sin force debe haber sesiones alojadas y alguna sin enviar. force: true regenera pasos compatibles; no omite comprobaciones de aprobación, rechazo, caducidad o pertenencia.
Noah comprueba primero la verificación del cliente. Si está aprobado, actualiza el caso local sin crear otra sesión alojada. Infinia consulta al titular de la cuenta bajo la empresa: COMPLETED aprueba el caso, FAILED registra el motivo y borra los pasos alojados, y un estado pendiente conserva los pasos actuales. Una respuesta exitosa puede contener un caso pendiente o fallido; revise data.case.status. La respuesta contiene customerId y case dentro de data. Revise status, reason, hostedSessions, actions y availableActions. Si ya estaba aprobado, devuelve HTTP 200 con el mensaje Onboarding case is already approved. Los demás casos terminales devuelven HTTP 400.

Después de la aprobación

Solicite nuevas tasas de retiro o una nueva cotización de depósito para crear una sesión fiat nueva. No reutilice una sesión anterior a la aprobación. Los cambios también pueden emitir webhooks customer.onboarding.*; un caso sin cambios no garantiza un evento nuevo. Webhooks de incorporación de clientes

Autorizaciones

x-api-key
string
header
requerido

Parámetros de ruta

customerId
string<uuid>
requerido

Customer identifier.

caseId
string<uuid>
requerido

Customer onboarding case identifier.

Cuerpo

application/json

Send {} to check provider verification or refresh normally. force is optional and defaults to false.

force
boolean
predeterminado:false

Force hosted-session regeneration only in the supported renewal path. Does not bypass provider verification, terminal-state checks or ownership. With false, existing sessions must exist and not all be submitted.

Respuesta

Verification synchronized, hosted steps refreshed, or case already approved.

status
boolean
requerido
Ejemplo:

true

message
string
requerido
data
object
requerido