---
title: "Registro de pessoa física"
method: PUT
path: "/customers/{documentNumber}"
tags: ["Pessoa física"]
---

# Registro de pessoa física

`PUT /customers/{documentNumber}`

## Request

- Base URL: `https://api-mtls.sandbox.bankly.com.br`
- URL: `https://api-mtls.sandbox.bankly.com.br/customers/{documentNumber}`
- Auth: HTTP bearer

<div class="bkly-ref-description">
  <p>Registre um cliente pessoa física. Se os dados informados já existirem, eles serão sobrepostos. <br/>Após o registro, as informações serão analisadas e você poderá obter o resultado dessa análise por meio do <i>endpoint</i> <a href="/reference/getcustomerregistration">Consulta do registro do cliente</a>.</p>
  <span class="bkly-ref-small-stable-tag">stable</span> 
  <span class="bkly-ref-scope-tag">scope: customer.write</span>
</div>      
[block:callout]
{
  "type": "warning",
  "title": "Importante",
  "body": "Os possíveis <i>status</i> do cliente após essa análise são: PENDING_APPROVAL, APPROVED, IN_ANALYSIS, REPROVED e BLACKLISTED. Para mais informações, consulte a documentação [Onboarding de pessoa física](/docs/onboarding-completo)."
}
[/block]

## Path parameters

- `documentNumber` string, required: Número do documento CPF do cliente do cliente pessoal ou representante legal.

## Parameters

- `#/paths/~1business~1{documentNumber}/put/parameters/1` (unresolved $ref)
- `#/paths/~1business~1{documentNumber}/put/parameters/2` (unresolved $ref)

## Request body

- RegisterCustomerRequest
  - `registerName` string, required: Nome completo conforme consta no documento de identificação (RG, CNH, RNE, DNI ou CRNM) do cliente. <b>Sem abreviações</b>.
  - `socialName` string, nullable: Nome pelo qual a pessoa gostaria de ser chamada. Saiba mais consultando a [Cartilha do nome social](https://www.mds.gov.br/webarquivos/publicacao/assistencia_social/Folders/cartilha_nome_social.pdf).
  - `birthDate` string, date-time, required: Data de nascimento do cliente.
  - `phone` PhonePf, required
    - `countryCode` string, required: Código DDI do país. Atente-se à lista de países bloqueados para o Onboarding presente na página <a href="https://docs.bankly.com.br/docs/registro-pessoa-fisica">Registro de pessoa física</a>.
    - `number` string, required: Número de telefone incluindo DDD.
  - `address` Address, required
    - `zipCode` string, required: Código postal do endereço.
    - `addressLine` string, required: Logradouro (nome da rua, avenida etc.).
    - `buildingNumber` string, required: Número do imóvel.
    - `complement` string, nullable: Complemento do endereço. Exemplo: Apto 123, Casa B etc.
    - `neighborhood` string, required: Nome do bairro ou distrito.
    - `city` string, required: Nome da cidade.
    - `state` string, required: Sigla do estado brasileiro conforme a ISO 3166-2:BR.
    - `country` string, required: Sigla do país (Brasil) conforme a ISO 3166-2. Exemplo: BR.
  - `declaredIncome` 'LESS_THAN_ONE_THOUSAND' | 'FROM_ONE_THOUSAND_TO_TWO_THOUSAND' | 'FROM_TWO_THOUSAND_TO_THREE_THOUSAND' | 'FROM_THREE_THOUSAND_TO_FIVE_THOUSAND' | 'FROM_FIVE_THOUSAND_TO_TEN_THOUSAND' | 'FROM_TEN_THOUSAND_TO_TWENTY_THOUSAND' | 'OVER_TWENTY_THOUSAND': Faixa de renda declarada pelo cliente. Campo <b>obsoleto</b> em produção a partir do dia 27/11/2023. Deve ser substituído pelo objeto <code>assertedIncome</code>.
  - `assertedIncome` AssertedIncome, required: Objeto que deverá conter os dados da renda do cliente.
    - `value` number, required: Valor em Reais da renda declarada pelo cliente. O valor mínimo para esse campo é de: 0.00, e o valor máximo: 99999999999999.99 (até 14 caracteres antes do ponto e até dois caracteres após o ponto).
    - `currency` string: Moeda da renda declarada.
  - `occupation` 'OCP0001' | 'OCP0002' | 'OCP0003' | 'OCP0004' | 'OCP0005' | 'OCP0006' | 'OCP0007' | 'OCP0008' | 'OCP0009' | 'OCP0010' | 'OCP0011' | 'OCP0012' | 'OCP0013' | 'OCP0014' | 'OCP0015' | 'OCP0016' | 'OCP0017' | 'OCP0018' | 'OCP0019' | 'OCP0020' | 'OCP0021' | 'OCP0022' | 'OCP0023' | 'OCP0024' | 'OCP0025' | 'OCP0026' | 'OCP0027' | 'OCP0028' | 'OCP0029' | 'OCP0030' | 'OCP0031' | 'OCP0032' | 'OCP0033' | 'OCP0034' | 'OCP0035' | 'OCP0036' | 'OCP0037' | 'OCP0038' | 'OCP0039' | 'OCP0040' | 'OCP0041' | 'OCP0042' | 'OCP0043' | 'OCP0044' | 'OCP0045' | 'OCP0046' | 'OCP0047' | 'OCP0048' | 'OCP0049' | 'OCP0050' | 'OCP0051' | 'OCP0052' | 'OCP0053' | 'OCP0054' | 'OCP0055' | 'OCP0056' | 'OCP0057' | 'OCP0058' | 'OCP0059' | 'OCP0060' | 'OCP0061' | 'OCP0062' | 'OCP0063' | 'OCP0064' | 'OCP0065' | 'OCP0066' | 'OCP0067' | 'OCP0068' | 'OCP0069' | 'OCP0070' | 'OCP0071' | 'OCP0072' | 'OCP0073' | 'OCP0074' | 'OCP0075' | 'OCP0076' | 'OCP0077' | 'OCP0078' | 'OCP0079' | 'OCP0080' | 'OCP0081' | 'OCP0082' | 'OCP0083' | 'OCP0084' | 'OCP0085' | 'OCP0086' | 'OCP0087' | 'OCP0088' | 'OCP0089' | 'OCP0090' | 'OCP0091' | 'OCP0092' | 'OCP0093' | 'OCP0094' | 'OCP0095' | 'OCP0096' | 'OCP0097' | 'OCP0098' | 'OCP0099' | 'OCP0100' | 'OCP0101' | 'OCP0102' | 'OCP0103' | 'OCP0104' | 'OCP0105', required: Código de ocupação do cliente. Para conhecer a descrição dos códigos das ocupações, consulte a documentação [Código de ocupação do cliente](https://docs.bankly.com.br/docs/codigo-de-ocupacao-cliente). <br/><b>Importante:</b> deve-se enviar somente o código. Caso o cliente possua mais de uma ocupação, esse campo deve ser preenchido com a sua principal fonte de renda.
  - `pep` Pep, required: Objeto onde deve ser informado o nível de exposição política do cliente, atendendo à Circular nº 3.978.
    - `level` 'NONE' | 'SELF' | 'RELATED', required: Nível de exposição política do cliente.
  - `motherName` string, nullable, required: Nome completo da mãe do cliente conforme consta no documento de identificação. <b>Sem abreviações</b>.
  - `email` string, required: Endereço de <i>e-mail</i>.
  - `documentation` SendedDocumentationRequest, required: Objeto onde devem ser informadas as referências dos documentos enviados para análise.
    - `selfie` string, required: <i>Token</i> retornado no <i>endpoint</i> de [Envio e análise de documentos pessoais com ID One](https://docs.bankly.com.br/docs/envio-documentos-analise-id-one).
    - `idCardFront` string, required: <i>Token</i> retornado no <i>endpoint</i> de [Envio e análise de documentos pessoais com ID One](https://docs.bankly.com.br/docs/envio-documentos-analise-id-one).
    - `idCardBack` string, required: <i>Token</i> retornado no <i>endpoint</i> de [Envio e análise de documentos pessoais com ID One](https://docs.bankly.com.br/docs/envio-documentos-analise-id-one).

## Other responses

- `202` (unresolved $ref)
- `400` (unresolved $ref)
- `403` (unresolved $ref)
- `409` (unresolved $ref)
- `422` (unresolved $ref)
- `500` (unresolved $ref)

---

[API](https://skmtc.dev/bankly/apis/registro-do-cliente.md) - [All operations](https://skmtc.dev/bankly/apis/registro-do-cliente/llms.txt) - [OpenAPI document](https://skmtc.dev/bankly/apis/registro-do-cliente/revisions/8062de128aa6?raw)