申请账户预留

Request

ENDPOINT

/account_request/draft_checking

MÉTODO

POST

账户开立

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",
      "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"
      },
      "monthly_income":1000
   }
}

账户开立

Request Body 参数

字段	类型	描述
account_owner*	object	账户持有人详情，包括地址和个人信息。

account_owner 对象

字段	类型	描述
address*	object	账户持有人地址。
birth_date*	string	持有人出生日期（格式 "YYYY-MM-DD"）。
email*	string	账户持有人电子邮件。
individual_document_number*	string	持有人 CPF（仅数字）。
is_pep*	boolean	声明该人是否为 PEP。
mother_name*	string	持有人母亲姓名。
name*	string	持有人全名。
nationality	string	持有人国籍。
person_type*	enum	人员类型，个人账户始终为 "natural"。
phone*	object	持有人电话。
monthly_income	number	持有人月收入。

address 对象

字段	类型	描述	字符数
street*	string	街道地址	-
state*	enum	州	2
city*	string	城市	-
neighborhood*	string	区/社区	-
number*	string	门牌号	-
postal_code*	string	邮政编码	-
complement	string	地址补充信息	-

phone 对象

字段	类型	描述
country_code*	string	电话国际区号
area_code*	string	区号
number*	string	电话号码

person_type 枚举值

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

Response

STATUS

201

Response Body

{
    "account_number": "1638634",
    "reserved_account_status":"reserved",
    "account_type":  "checking",
    "account_digit": "3",
    "account_key": "b1690f7b-1e82-4f76-a8d3-c326a2b89b67",
    "account_branch": "0001",
    "account_name": "Nome do Proprietário",
    "created_at": "2023-10-07T15:52:24"
}

注意

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