确认开立个人账户

作为个人账户开立的第二步，完成账户预留后，需要提交账户持有人的完整注册信息及账户开立条款的接受证明。

Request

ENDPOINT

/account_request/ACCOUNT_REQUEST_KEY/checking

MÉTODO

PATCH

Path Params

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

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"
            }
        ]
    },
    "additional_documents": ["b12c8807-8f3f-4083-9cb1-7cce641f3786"]
}

Request Body 参数

字段	类型	描述	字符数
account_owner *	object	包含账户持有人信息的对象	account_owner 对象
signed_contract *	object	包含持有人接受账户开立条款证明的对象。	signed_contract 对象

account_owner 对象

字段	类型	描述	字符数
address *	string	客户地址。	address 对象
birth_date *	string	出生日期（格式 "YYYY-MM-DD"）
document_identification *	string	附有照片的身份证明文件（RG 或 CNH）PDF 的 DOCUMENT_KEY（预先上传）
email *	string	客户电子邮件。
individual_document_number*	string	个人 CPF（仅数字），最多 11 个字符。
is_pep *	string	声明该人是否为 PEP（http://www.portaldatransparencia.gov.br/download-de-dados/pep）。
mother_name *	string	个人账户持有人母亲姓名。	100
name *	string	企业法定名称（PJ）或个人姓名（PF）。	100
nationality *	string	客户国籍。	50
person_type *	string	标识所提交对象为自然人或法人。
phone *	string	电话数据对象	phone 对象
proof_of_residence	string	所提供地址的居住证明 PDF 的 DOCUMENT_KEY（预先上传）。
monthly_income*	number	账户持有人月收入

address 对象

此对象出现在 PF 和 PJ 对象中，用于表示地址信息。

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

signed_contract 对象

字段	类型	描述	字符数
document_key *	uuidv4	账户开立条款或托管账户合同文件的唯一标识键。（DOCUMENT_KEY 由文件上传端点的响应返回）	36
signatures *	list	所提交文件的签名数据。列表中每个项目对应文件的一个签署人。	signatures 对象

signatures 对象

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

authenticity 对象

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

signer 对象

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

phone 对象

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

Response

STATUS

201

Response Body

 { "account_key": "78ea0fa6-8ea6-46ff-b66b-d2bc36fc8869" }

注意

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

Response Body 参数

字段	类型	描述	字符数
account_key *	string	账户唯一标识键	-

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
400	QIT000001	Bad Request	Schema Error	Erro de Schema
404	QIT000404	Not Found	Resource could not be found	Recurso não encontrado