确认开立个人账户

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

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

Request​

Path Params​

Request Body 参数​

account_owner 对象​

address 对象​

signed_contract 对象​

signatures 对象​

authenticity 对象​

signer 对象​

phone 对象​

Response​

Response Body 参数​