跳到主要内容

确认开设个人账户

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

Request​

ENDPOINT
/account_request/ACCOUNT_REQUEST_KEY/escrow
MÉTODO
PATCH

Path Params​

字段类型描述字符数
account_request_keyuuidv4账户预留请求的唯一标识键。36

开设 Escrow 账户​

Request Body
{
    "account_owner": {
        "address": {
            "street": "Av. Brigadeiro Faria Lima",
            "state": "SP",
            "city": "São Paulo",
            "neighborhood": "Jardim Paulistano",
            "number": "2391",
            "postal_code": "01452905",
            "complement": "Complemento"
        },
        "birth_date": "1990-05-06",
        "document_identification": "3884579b-9810-4fa6-9b08-fe67d237160a",
        "email": "teste@gmail.com",
        "individual_document_number": "99999999999",
        "is_pep": false,
        "mother_name": "Dona Maria Mariane",
        "name": "Nome do Titular da Conta",
        "nationality": "nationality",
        "person_type": "natural",
        "phone": {
            "country_code": "055",
            "area_code": "11",
            "number": "999999999"
        },
        "proof_of_residence": "4d7f4e-1eec-4e5f-82c0-d8c3921497ea",
        "monthly_income": 1000
    },
    "signed_contract": {
        "document_key": "48a8f4g9-4b58-4905-9a69-b1f9215263f5",
        "signatures": [
            {
                "authenticity": {
                    "timestamp": "1970-01-01T00:00:01.080100Z",
                    "facial_recognition_key":"79003de0-2590-455d-9b73-426b8ca284eb",
                    "lang": "-35.8916627",
                    "lat": "-7.2226067",
                    "ip_address": "177.51.1.186",
                    "session_id": "jdifj329842"
                },
                "signer": {
                    "name": "Nome do Titular da Conta",
                    "email": "teste@gmail.com",
                    "phone": {
                        "country_code": "055",
                        "area_code": "11",
                        "number": "999999999"
                    },
                    "document_number": "999999999"
                },
                "authentication_type": "opt-in"
            }
        ]
    },
    "destinations": [
        {
            "account_branch": "0001",
            "account_number": "1234567",
            "account_digit": "1",
            "document_number": "04252012000123",
            "name": "Conta do FIDC",
            "ispb_number": "32402502",
            "financial_institution_code_number": "329"
        }
    ],
    "additional_documents": ["b12c8807-8f3f-4083-9cb1-7cce641f3786"]
}

Request Body Params​

字段类型描述字符数
account_owner *object包含账户持有人信息的对象Objeto account_owner
signed_contract *object包含账户持有人信息的对象Objeto signed_contract
destinations *list授权接收转账的目标账户列表。Objeto destinations
additional_documentslist额外/可选文件 ID 列表。UUID 数组

Objeto account_owner​

字段类型描述字符数
address *object账户持有人地址。Objeto adress
birth_date *string账户持有人出生日期（格式 "AAAA-MM-DD"）。-
document_identification *uuidv4账户持有人带照片身份证件 PDF 的 DOCUMENT_KEY（RG 或 CNH）（事先上传）36
email *string账户持有人邮箱。200
individual_document_numberstring账户持有人 CPF（仅数字），最多 11 位。11
is_pep *string声明该人是否为 PEP（http://www.portaldatransparencia.gov.br/download-de-dados/pep）。-
mother_name *string个人账户情况下客户的母亲姓名。-
name *string账户持有人姓名。-
nationality *string客户国籍。-
person_type *enumerator标识发送的对象是自然人还是法人。Enumeradores person_type
phone *string包含电话数据的对象Objeto phone
proof_of_residencestring所发送地址的居住证明 PDF 的 DOCUMENT_KEY（事先上传）。-
monthly_income*number账户持有人月收入

Objeto address​

此对象在个人和企业对象中均存在，是一个简单的地址表示对象。

字段类型描述字符数
street *string地址街道500
state *string地址州（两位大写字母）2
city *string地址城市255
neighborhood *string地址街区500
number *string门牌号10
postal_code *string邮政编码（http://www.buscacep.correios.com.br/sistemas/buscacep/）（仅数字）8
complement *string地址补充信息（自由文本）500

Objeto destinations​

字段类型描述字符数
account_branch *string目标账户机构编号。4
account_number *string目标账户号码。-
account_digit *string目标账户号码校验位。1
document_number *string目标账户持有人 CPF/CNPJ。-
name string目标账户持有人姓名/公司名称。-
ispb_number *string目标账户金融机构的 ISPB（CNPJ 基础）。8
financial_institution_code_number *string目标账户金融机构代码。3

Objeto signed_contract​

字段类型描述字符数
document_key *uuidv4账户开设条款或 Escrow 账户合同文件的唯一标识键。（DOCUMENT_KEY 在文件上传端点响应中返回）36
signatures *list发送文件的签名数据。列表中每一项对应一位文件签署人。Objeto signatures

Objeto signatures​

字段类型描述字符数
authenticity *object证明签署人完成电子签名的数据集。Objeto authenticity
signer *object包含文件签署人之一数据的对象。Objeto signer
authentication_type *enumerator签名类型。始终为 "opt-in""opt-in"

Enumeradores person_type​

枚举值描述
natural *自然人
legal *法人

Objeto authenticity​

字段类型描述字符数
timestamp *string文件签署的日期和时间。27
facial_recognition_key *uuidv4账户持有人自拍照的唯一标识键。36
langstring签署时捕获的签署人地理位置经度坐标。-
latstring签署时捕获的签署人地理位置纬度坐标。-
ip_addressstring签署人设备的 IP 地址。-
session_id *string签署时签署人的会话 ID。-

Objeto signer​

字段类型描述字符数
name *string签署人姓名。-
email *string签署人邮箱。-
phone *object包含签署人电话数据的对象Objeto phone
document_number *string签署人 CPF。11

Objeto phone​

字段描述示例最大字符数
country_code *string电话 DDI 代码（https://ddi.guiamais.com.br/）3
area_code *string电话 DDD 代码（https://ddd.guiamais.com.br/）3
number *string电话号码（仅数字）10

Response​

STATUS
201
Response Body
{
    
    "account_key": "e48eb139-448e-43b9-9aee-df5f4b51158c"
}
注意

account_key 字段将成为账户的唯一标识键。所有与账户的交互都将通过它进行。

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