注册新人员/客户

注册新客户或更新现有客户。在为客户在KYC提供商中预注册的合作伙伴创建申请之前,此步骤是必需的。

已认证合作伙伴的 source_kyc 配置决定了KYC提供商:

  • qitech — 数据转发至QI Tech CaaS进行分析;响应中的 kyc_status 反映分析结果。
  • openco(默认) — 仅在本地注册。

重新注册(活体验证重新验证): 如果 document_number 已存在但请求携带了不同的 person_id(来自新的活体验证),系统将:

  1. 将新的外部 person_id 映射到现有的内部标识符。
  2. 存储完整注册载荷的快照以供审计。
  3. 使用传入的值更新人员数据。
  4. 返回HTTP 200,包含现有的内部 person_id

同一人员可以随时间累积多个外部 person_id 映射(每次活体会话一个)。

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string

来自合作伙伴活体检测/KYC会话的外部人员标识符。 source_kyc: qitech的合作伙伴必填openco可选。 当为已存在的document_number提供时,系统会将此新外部ID映射到现有的内部标识符, 并存储注册请求的完整快照。

string
required

客户全名

string
required

客户CPF。支持格式化(如111.111.111-11)或纯数字(如11111111111)。 非数字字符在存储前由系统内部自动去除。

emails
array of objects
required

客户电子邮件地址

emails*
phones
array of objects
required

客户电话号码

phones*
address
object
required
date
required

客户出生日期(YYYY-MM-DD)

string
enum

客户性别

Show Details
maleMale
femaleFemale
otherOther / Non-binary
Allowed:
string

Country code (ISO 3166-1 alpha-3)

integer

Monthly income in cents (BRL)

string

Customer's occupation

string

Mother's full name

string

Father's full name

uuid

面部识别 ID,来自合作伙伴的生物识别采集 SDK。 可选便捷字段 — 提供时会在内部映射到 face.registration_key。 仅用于在注册前执行活体检测验证的合作伙伴。

uuid

会话标识符,来自合作伙伴的反欺诈 SDK。 可选便捷字段 — 提供时会在内部映射到 source.session_id。 用于入职流程的可追溯性。

Responses

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json