Pular para o conteúdo principal
Pede uma nova análise de crédito de um titular já verificado, com outro pedido e sem nova captura

Autorizações

Authorization
string
header
obrigatório

Chave secreta (unifokal_live_ em produção, unifokal_test_ no sandbox: 64 hex mais CRC-32) no Authorization: Bearer. Só no seu servidor: nunca no browser ou app (o widget monta apenas com o id vs_ da sessão). Não existe chave publishable.

Cabeçalhos

Idempotency-Key
string
obrigatório
Required string length: 1 - 255
Prefer
string

wait=N: quanto você aceita esperar pela decisão, em segundos.

Exemplo:

"wait=10"

Corpo

application/json

A verificação aprovada do titular (do mesmo ambiente da chave, com o motor credit_decision no flow), a relação declarada com ele agora (Lei 12.414, art. 15) e o pedido novo, no mesmo formato do credit_request da criação de sessão.

verification_id
string
obrigatório
Pattern: ^ver_[0-9A-HJKMNP-TV-Z]{26}$
credit_relationship
enum<string>
obrigatório
Opções disponíveis:
existing,
prospective
credit_request
object
obrigatório

Resposta

A análise terminou dentro do prazo do Prefer: wait (decided, failed ou canceled).

id
string
obrigatório
Pattern: ^can_[0-9A-HJKMNP-TV-Z]{26}$
object
enum<string>
obrigatório
Opções disponíveis:
credit_analysis
verification_id
string
obrigatório
Pattern: ^ver_[0-9A-HJKMNP-TV-Z]{26}$
status
enum<string>
obrigatório

running: as fontes estão sendo consultadas; decided: credit_decision traz a decisão; failed: o motor não decidiu (nada cobrado, peça de novo); canceled: a identidade saiu de approved (negada ou bloqueada) antes da decisão.

Opções disponíveis:
running,
decided,
failed,
canceled
credit_decision
object | null
obrigatório

A decisão, a mesma do bloco data do check credit_decision no webhook. null até decided.

previous_analysis_id
string | null
obrigatório

A decisão viva quando a análise começou: ela continua valendo até esta decidir, e então é substituída.

Pattern: ^cda_[0-9A-HJKMNP-TV-Z]{26}$
end_reason
string | null
obrigatório

Por que terminou sem decisão: credit_engine_failed (o motor não decidiu), superseded_by_identity (a identidade saiu de approved), credit_requester_unverified ou credit_declaration_missing (o portão de crédito fechou) e credit_review_open (o titular pediu a revisão da decisão vigente). Em todos, a decisão anterior continua valendo.

missing_authorizations
object[]
obrigatório

As fontes não consultadas porque falta, foi revogada ou venceu a autorização do titular (a análise decide sem elas).

created_at
string<date-time>
obrigatório
ended_at
string<date-time> | null
obrigatório