跳转到主要内容
POST
Refresh status
此操作用于现有客户审核案例。路径必须同时提供 customerId 和 caseId。案例必须属于该客户和已认证企业。

续期前验证

正常流程发送空 JSON 对象。force 默认为 false。服务商没有返回状态更新时,续期要求 availableActions 包含 refresh_provider_steps。未设置 force 时,必须已有托管会话且至少一个尚未提交。force: true 可重新生成支持的托管步骤,但不能绕过批准、拒绝、过期或归属检查。
Noah 先查询客户验证状态。已批准的客户会在本地获批,无需新建托管会话。Infinia 查询企业下的客户账户所有人:COMPLETED 会批准案例,FAILED 会保存失败原因并清除托管步骤,待审核状态则保留当前步骤。成功响应仍可能返回待审核或失败案例,请检查 data.case.status。 响应的 data 包含 customerId 和 case。请检查 status、reason、hostedSessions、actions 和 availableActions。本地已批准的案例返回 HTTP 200 和消息 Onboarding case is already approved。其他终态案例返回 HTTP 400。

批准之后

重新请求提现汇率或充值报价以创建新的法币会话。不要复用批准前创建的会话。状态变化也可能发出 customer.onboarding.* webhooks;案例未变化时不保证产生新事件。 客户审核 Webhooks

授权

x-api-key
string
header
必填

路径参数

customerId
string<uuid>
必填

Customer identifier.

caseId
string<uuid>
必填

Customer onboarding case identifier.

请求体

application/json

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

force
boolean
默认值: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.

响应

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

status
boolean
必填
示例:

true

message
string
必填
data
object
必填