Confirm Individual Account Opening

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

Request

ENDPOINT

/account_request/ACCOUNT_REQUEST_KEY/checking

METHOD

PATCH

Path Params

Field	Type	Description	Characters
account_request_key	uuidv4	Unique identification key for 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",
        "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 Params

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

account_owner Object

Field	Type	Description	Characters
address *	string	Customer address.	address Object
birth_date *	string	Person's date of birth (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 uploaded)
email *	string	Customer email.
individual_document_number*	string	Person's CPF (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 individuals.	100
name *	string	Company name for business operations or Person's name for individual operations.	100
nationality *	string	Customer nationality.	50
person_type *	string	Identifier indicating whether the submitted object is an individual or legal entity.
phone *	string	Object with phone data	phone Object
proof_of_residence	string	DOCUMENT_KEY of the PDF proof of address for the submitted address (previously uploaded).
monthly_income*	number	Account holder's monthly income

address Object

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

Field	Description	Example	Max Characters
street *	string	Street address	100
state *	enum	Address state (two uppercase characters)	2
city *	string	Address city	100
neighborhood *	string	Address neighborhood	100
number *	string	Street number	10
postal_code *	string	Address postal code (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 for the submitted document. Each list item corresponds to one 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 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 when the document was signed.	27
facial_recognition_key*	uuidv4	Unique identification key of the account holder's selfie photo.	36
lang	string	Longitude coordinate of the signer's geolocation captured at the time of signing.	-
lat	string	Latitude coordinate of the signer's geolocation captured at the time of signing.	-
ip_address	string	IP address of the signer's device.	-
session_id *	string	Signer's session ID at the time of signing.	-

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 CPF.	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_key": "78ea0fa6-8ea6-46ff-b66b-d2bc36fc8869" }

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_key *	string	Unique account identification key	-

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