Saltar para o conteúdo principal
POST
Refresh status
Use esta operação para um caso de onboarding existente. customerId e caseId são obrigatórios. O caso deve pertencer ao cliente e à empresa autenticada.

Verificação antes da renovação

Envie um objeto JSON vazio no fluxo normal. force tem padrão false. Se o provedor não retornar atualização, a renovação exige refresh_provider_steps em availableActions. Sem force, devem existir sessões hospedadas e pelo menos uma não enviada. force: true regenera etapas compatíveis, mas não ignora aprovação, rejeição, expiração ou titularidade.
Noah verifica primeiro o status do cliente. Se aprovado, atualiza o caso local sem criar outra sessão hospedada. Infinia consulta o titular da conta sob a empresa: COMPLETED aprova localmente, FAILED registra o motivo e limpa etapas hospedadas, e a verificação pendente preserva as etapas atuais. Uma resposta bem-sucedida pode retornar um caso pendente ou com falha; confira data.case.status. A resposta contém customerId e case dentro de data. Confira status, reason, hostedSessions, actions e availableActions. Casos já aprovados retornam HTTP 200 com a mensagem Onboarding case is already approved. Outros casos terminais retornam HTTP 400.

Após a aprovação

Solicite novas taxas de saque ou uma nova cotação de depósito para criar outra sessão fiat. Não reutilize a sessão anterior à aprovação. Mudanças também podem emitir webhooks customer.onboarding.*; casos sem mudanças não garantem outro evento. Webhooks de onboarding de clientes

Autorizações

x-api-key
string
header
obrigatório

Parâmetros de caminho

customerId
string<uuid>
obrigatório

Customer identifier.

caseId
string<uuid>
obrigatório

Customer onboarding case identifier.

Corpo

application/json

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

force
boolean
padrão: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.

Resposta

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

status
boolean
obrigatório
Exemplo:

true

message
string
obrigatório
data
object
obrigatório