Confirm Individual Account Opening

As a second step in individual account opening, after account reservation, the complete registration data of the account holder and evidence of acceptance of the account opening terms must be sent.

Request

ENDPOINT

/account_request/checking

METHOD

POST

Path Params

Field	Type	Description	Characters
`account_request_key`	uuidv4	Unique identification key for the account reservation request.	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"
    },
    "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 Params

Field	Type	Description	Characters
`account_owner` *	object	Object containing the Account Holder information	account_owner Object
`signed_contract` *	object	Object containing evidence of the Holder's acceptance of the account opening terms.	signed_contract Object

account_owner Object

Field	Type	Description	Characters
`address` *	string	Customer address.	address Object
`birth_date` *	string	Person's birth date (format "YYYY-MM-DD")
`document_identification` *	string	DOCUMENT_KEY of the PDF of the person's photo identification document (ID or Driver's License) (previously sent)
`document_identification_type` *	string	Type of previously sent document (ID or Driver's License)
`email` *	string	Customer email.
`individual_document_number`	string	Person's SSN (numbers only). Limited to 11 characters.
`is_pep` *	string	Declaration if the person is PEP (http://www.portaldatransparencia.gov.br/download-de-dados/pep).
`mother_name` *	string	Customer's mother's name for individual customers.	100
`name` *	string	Company name for corporate operations or Person's name for individual operations.	100
`nationality` *	string	Customer nationality.	50
`person_type` *	string	Identifier whether the sent object is an individual or corporate person.
`phone` *	string	Object with phone data	phone Object
`proof_of_residence`	string	DOCUMENT_KEY of the PDF proof of address for the sent address (previously sent).

address Object

This object, present in both individual and corporate objects, is a simple object to represent an address.

Field	Description	Example	Max. Characters
`street` *	string	Street address	100
`state` *	string	State of the address (with two uppercase characters)	2
`city` *	string	City of the address	100
`neighborhood` *	string	Neighborhood of the address	100
`number` *	string	Street number	10
`postal_code` *	string	ZIP code of the address (http://www.buscacep.correios.com.br/sistemas/buscacep/) (numbers only)	8
`complement` *	string	Address complement (free text)	100

signed_contract Object

Field	Type	Description	Characters
document_key *	uuidv4	Unique identification key of the Account Opening Terms or Escrow Account Contract document. (The DOCUMENT_KEY is returned in the response of the Document upload endpoint)	36
signatures *	list	Signature data of the sent document. Each item in the list corresponds to a document signer.	signatures Object

signatures Object

Field	Type	Description	Characters
authenticity *	object	Set of data that evidences the electronic signature performed by the signer.	authenticity Object
signer *	object	Object containing the data of one of the document signers.	signer Object
authentication_type *	enumerator	Signature type. Will always be "opt-in"	"opt-in"

authenticity Object

Field	Type	Description	Characters
timestamp *	string	Date and time of the document signing moment.	27
facial_recognition_key	uuidv4	Unique identification key of the account holder's selfie photo. (The DOCUMENT_KEY is returned in the response of the Document upload endpoint)	36
lang	string	Longitude coordinate of the signer's geolocation captured at the signing moment.	-
lat	string	Latitude coordinate of the signer's geolocation captured at the signing moment.	-
ip_address	string	IP address of the signer's device.	-
session_id	string	Signer's session ID at the signing moment.	-

signer Object

Field	Type	Description	Characters
name *	string	Signer's name.	-
email *	string	Signer's email.	-
phone *	object	Object with signer's phone data	phone Object
document_number *	string	Signer's SSN.	11

phone Object

Field	Description	Example	Max. Characters
`country_code` *	string	Phone country code (https://ddi.guiamais.com.br/)	3
`area_code` *	string	Phone area code (https://ddd.guiamais.com.br/)	2
`number` *	string	Phone number (numbers only)	10

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_kyc_analysis"
}

Warning

The account_request_key field must be stored and will be used for account opening confirmation.

Response Body Params

Field	Type	Description	Characters
`account_info` *	object	Object containing the Account Holder information	account_info Object
`account_request_key` *	string	Creation request identification key	-
`account_request_status` *	string	KYC status	-

account_info Object

Field	Type	Description	Characters
`account_branch` *	string	Branch Number	4
`account_digit` *	string	Email	11
`account_number` *	string	Account Holder Full Name	50

STATUS

4xx

Response Body: Error

{
  "title": "titulo",
  "description": "description in English",
  "translation": "descrição em portugues",
  "code": "codigo",
  "extra_fields": {}
}

HTTP Code `status`	QI Code `code`	Title `title`	Description (eng) `description`	Description(ptbr) `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 Params​

account_owner Object​

address Object​

signed_contract Object​

signatures Object​

authenticity Object​

signer Object​

phone Object​

Response​

Response Body Params​

account_info Object​