跳到主要内容

开设企业账户

账户开设分两个必要步骤。首先，POST 请求发送初步数据以预留账户。随后，系统会触发状态为 pending_additional_data 的 account_request.status_change 类型 webhook。在第二步中，PATCH 请求完成开户，以补充信息正式确认账户。

申请预留账户​

Request​

ENDPOINT
/account_request/escrow
MÉTODO
POST
Request Body
{
    "account_owner": {
        "company_document_number": "99999999999",
        "email": "email@teste.com",
        "foundation_date": "2017-09-16",
        "name": "Nome da Empresa"
    },
    "legal_representatives": [
        {
            "birthdate": "1963-07-23",
            "name": "Don Corleone",
            "document_number": "03912394323",
            "documents": {
                "national_registry_of_foreigners": {
                    "ocr_front_key": "0aa8a4ca-5873-49bd-851c-1f2c71a1cc28",
                    "ocr_back_key": "29f6e346-7fae-4dcb-9ea1-2a3e4ef593ea"
                }
            },
            "face": "68da08f1-6cf4-4dce-a297-7b2f09311784"
        },
        {
            "birthdate": "1996-03-10",
            "name": "John Doe",
            "document_number": "39113492093",
            "documents": {
                "cnh": {
                    "ocr_key": "beee557e-9240-4c5b-88f1-42812b195168"
                }
            }
        }
    ]
}
CPF/CNPJ 模拟

要模拟审批、拒绝和人工审核等情况，可使用账户 owner 的 CPF/CNPJ 第一位数字：

0 至 6 -> 人工审核

7 -> 被 bacen protege+ 拒绝

8 -> KYC 自动拒绝

9 -> 自动审批

Request Body Params​

字段类型描述字符数
account_owner *object包含账户持有人信息的对象Objeto account_owner
legal_representativesobject array账户代表及其数据列表Objeto legal_representative

Objeto account_owner​

字段类型描述字符数
"company_document_number" *string账户持有人 CNPJ14
email *string合同持有企业邮箱200
foundation_date *string企业成立日期（格式 YYYY-MM-DD）10
name *string企业名称（社会名称）50
字段类型描述字符数
document_number *string账户持有人 CPF11
birthdate *string出生日期（格式 YYYY-MM-DD）10
name *string账户持有人姓名50
documents *object账户持有人证件Objeto documents
faceuuidv4反欺诈人脸识别键（face_recognition_key）36

Objeto documents​

字段类型描述字符数
rgobject持有人 RG 正反面 OCR 键Objeto rg
cnhobject持有人 CNH OCR 键Objeto cnh
cnh_digitalobject持有人数字 CNH OCR 键Objeto cnh_digital
national_registry_of_foreignersobject持有人 RNE 正反面 OCR 键Objeto national_registry_of_foreigners
national_migration_registryobject持有人 CRNM 正反面 OCR 键Objeto national_migration_registry
passportobject持有人护照 OCR 键Objeto passport
cin_digitalobject持有人数字国家身份证 OCR 键Objeto cin_digital
信息

上传文档图片的 OCR 键（ocr_key 或 ocr_front_key 和 ocr_back_key）由反欺诈系统图片上传响应提供。face_recognition_key 在人脸识别响应中返回。

Objeto rg​

字段类型描述字符数
ocr_front_key *uuidv4RG 正面图片 OCR 键36
ocr_back_key *uuidv4RG 背面图片 OCR 键36

或

字段类型描述字符数
ocr_key *uuidv4RG 图片 OCR 键36

Objeto cnh​

字段类型描述字符数
ocr_front_key *uuidv4CNH 正面图片 OCR 键36
ocr_back_key *uuidv4CNH 背面图片 OCR 键36

或

字段类型描述字符数
ocr_key *uuidv4CNH 图片 OCR 键36

Objeto cnh_digital​

字段类型描述字符数
ocr_key *uuidv4数字 CNH 图片 OCR 键36

Objeto national_registry_of_foreigners​

字段类型描述字符数
ocr_front_key *uuidv4RNE 正面图片 OCR 键36
ocr_back_key *uuidv4RNE 背面图片 OCR 键36

或

字段类型描述字符数
ocr_key *uuidv4RNE 图片 OCR 键36

Objeto national_migration_registry​

字段类型描述字符数
ocr_front_key *uuidv4CRNM 正面图片 OCR 键36
ocr_back_key *uuidv4CRNM 背面图片 OCR 键36

或

字段类型描述字符数
ocr_key *uuidv4CRNM 图片 OCR 键36

Objeto passport​

字段类型描述字符数
ocr_key *uuidv4护照图片 OCR 键36

Objeto cin_digital​

字段类型描述字符数
ocr_key *uuidv4数字国家身份证图片 OCR 键36

Response​

STATUS
201
Response Body
{
    "account_info": {
        "account_branch": "0001",
        "account_digit": "0",
        "account_number": "1693580"
    },
    "account_request_key": "f230f1b5-07af-4737-b0e3-8a472304f5e7",
    "account_request_status": "pending_bacen_validation"
}
Bacen Protege+ 流程

提案从 pending_bacen_validation 状态开始。系统在继续 KYC 分析之前，先向 Bacen Protege+ 进行预验证。Bacen 批准后，状态将自动更新为 pending_kyc_analysis。

注意

account_request_key 字段需保存，将用于确认开户。

Response Body Params​

字段类型描述字符数
account_info *object包含账户持有人信息的对象Objeto account_info
account_request_key *string创建请求的标识键-
account_request_status *stringKYC 状态-

Objeto account_info​

字段类型描述字符数
account_branch *string机构编号4
account_digit *string账户数字11
account_number *string账户号码50
STATUS
4xx
Response Body: Error
{
  "title": "titulo",
  "description": "description in English",
  "translation": "descrição em portugues",
  "code": "codigo",
  "extra_fields": {}
}
HTTP 代码
status		QI 代码
code		标题
title		描述（英文）
description		描述（葡文）
translation
400QIT000001Bad RequestSchema ErrorErro de Schema
404QIT000404Not FoundResource could not be foundRecurso não encontrado