46 - Update Account Owner

Scopes:

api.ext api.correntista.atualizar

Atualiza os Dados do Correntista.

cURL

curl --request POST \
  --url https://api.ext.dbs.moneyp.dev.br/api/Correntista/Atualizar \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'IdempotencyKey: <idempotencykey>' \
  --header 'IgnoraHandshake: <ignorahandshake>' \
  --data '
{
  "conta": {
    "agencia": "<string>",
    "agenciaDigito": "<string>",
    "conta": "<string>",
    "contaDigito": "<string>",
    "contaPgto": "<string>",
    "tipoConta": 1,
    "modeloConta": 1
  },
  "dadosCorrentista": {
    "documentoFederal": "<string>",
    "nome": "<string>",
    "tipoPessoa": 123,
    "situacao": 1
  },
  "dadosContato": {
    "email": "<string>",
    "telefoneFixo1": "<string>",
    "telefoneFixo2": "<string>",
    "telefoneCelular1": "<string>",
    "telefoneCelular2": "<string>",
    "telefoneFax": "<string>",
    "paginaWeb": "<string>"
  },
  "dadosEndereco": {
    "cep": "<string>",
    "logradouro": "<string>",
    "nroLogradouro": "<string>",
    "bairro": "<string>",
    "complemento": "<string>",
    "cidade": "<string>",
    "uf": "<string>",
    "tipoEndereco": 1,
    "tipoResidencia": 1,
    "enderecoDesde": "2023-11-07T05:31:56Z",
    "enderecoPrincipal": true,
    "enderecoCorrespondencia": true,
    "verificadoInLoco": true
  }
}
'

200

{
  "sucesso": true,
  "mensagem": "<string>"
}

Through this endpoint, the partner can execute the update of the account holders’ registration under the integrator’s domain.

Authorizations

Authorization · string · header · required

Copie 'Bearer ' + token

Headers

IdempotencyKey · string · required

IgnoraHandshake · boolean · default: true · required

(somente em homologação)

Body

conta · object

Objeto detalhado da conta bancária.*

Show child attributes

conta. agencia · string | null

Número da agência bancária.*

Observações:

• O número da agência pode ter no máximo 4 caracteres.

conta. agenciaDigito · string | null

Dígito verificador da agência bancária.

Observações:

• O dígito verificador da agência bancária pode ter no máximo 1 caracter.

conta. conta · string | null

Número da conta bancária.

Observações:

• O número da conta bancária pode ter no máximo 12 caracteres.
• Para que seja possível localizar a conta, é necessário informar o 'número da conta com dígito' (contaPgto) ou o 'número da conta' (conta) e o 'dígito verificador' (contaDigito).
• Caso o 'número da conta com dígito' (contaPgto) seja informado, não é necessário preencher os campos 'número da conta' (conta) e 'dígito verificador' (contaDigito).
• Caso nenhum dos campos referentes ao número da conta seja informado, ocorrerá erro na requisição devido à falta de informação vital.

conta. contaDigito · string | null

Dígito verificador do número da conta bancária.

Observações:

• O dígito verificador do número da conta bancária pode ter no máximo 1 caracter.

conta. contaPgto · string | null

Número da conta bancária seguido do dígito verificador.

Observações:

• O número da conta seguido do dígito verificador pode ter no máximo 20 caracteres.

conta. tipoConta · enum<integer>

Tipo da conta.*

Valores: 1 - Corrente 2 - Poupanca 3 - Pagamento 4 - Salario

Available options: 1, 2, 3, 4

conta. modeloConta · enum<integer>

Modelo da conta.*

Valores: 1 - Movimento 2 - Escrow 3 - Vinculada

Available options: 1, 2, 3

dadosCorrentista · object

Objeto detalhado do correntista vinculado à conta.*

Show child attributes

dadosCorrentista. documentoFederal · string | null

Número do CPF ou CNPJ do correntista.*

Observações:

• Informar apenas os números do documento sem os caracteres de formatação (exemplo: ponto, traço, barra, etc.).
• O número do documento federal do correntista pode ter no máximo 14 caracteres.

dadosCorrentista. nome · string | null

Nome completo do correntista.*

Observação:

• O nome do correntista pode ter no máximo 100 caracteres.

dadosCorrentista. tipoPessoa · integer<int32>

Tipo de pessoa.

Valores: 1 - PF 2 - PJ

dadosCorrentista. situacao · enum<integer>

Situacao.

Valores: 1 - Ativado 2 - Desativado

Available options: 1, 2

dadosContato · object

Objeto detalhado do contato do correntista vinculado à conta.*

Show child attributes

dadosContato. email · string | null

Email de contato do correntista.*

Observação:

• O email de contato do correntista pode ter no máximo 60 caracteres.

dadosContato. telefoneFixo1 · string | null

Número do 1º telefone fixo do correntista.

Observações:

• Informar o código de área seguido do número do telefone. Exemplo: 11551234567 (representa o telefone número 11 55123-4567)
• O número do 1º telefone fixo do correntista pode ter no máximo 20 caracteres.

dadosContato. telefoneFixo2 · string | null

Número do 2º telefone fixo do correntista.

Observações:

• Informar o código de área seguido do número do telefone. Exemplo: 11551234567 (representa o telefone número 11 55123-4567)
• O número do 2º telefone fixo do correntista pode ter no máximo 20 caracteres.

dadosContato. telefoneCelular1 · string | null

Número do 1º telefone celular do correntista.*

Observações:

• Informar o código de área seguido do número do telefone. Exemplo: 11987654321 (representa o telefone número 11 98765-4321)
• O número do 1º telefone celular do correntista pode ter no máximo 20 caracteres.

dadosContato. telefoneCelular2 · string | null

Número do 2º telefone celular do correntista.

Observações:

• Informar o código de área seguido do número do telefone. Exemplo: 11987654321 (representa o telefone número 11 98765-4321)
• O número do 2º telefone celular do correntista pode ter no máximo 20 caracteres.

dadosContato. telefoneFax · string | null

Número do fax do correntista.

Observações:

• Informar o código de área seguido do número do telefone. Exemplo: 11551234567 (representa o telefone número 11 55123-4567)
• O número do fax do correntista pode ter no máximo 20 caracteres.

dadosContato. paginaWeb · string | null

URL da página web do correntista.

Observação:

• A URL da página web do correntista pode ter no máximo 255 caracteres.

dadosEndereco · object

Objeto detalhado do endereço do correntista vinculado à conta.*

Show child attributes

dadosEndereco. cep · string | null

Código de endereçamento postal (CEP) do endereço.*

Observações:

• Informar apenas os números do CEP sem os caracteres de formatação (exemplo: ponto, traço, barra, etc.).
• O código de endereçamento postal (CEP) pode ter no máximo 8 caracteres.

dadosEndereco. logradouro · string | null

Logradouro do endereço. Exemplo: Rua das Flores, Avenida Brasil, Travessa Bachmann, etc.*

Observação:

• O logradouro do endereço pode ter no máximo 100 caracteres.

dadosEndereco. nroLogradouro · string | null

Número do endereço.*

Observação:

• O número do endereço pode ter no máximo 15 caracteres.

dadosEndereco. bairro · string | null

Bairro do endereço.

Observação:

• O bairro do endereço pode ter no máximo 50 caracteres.

dadosEndereco. complemento · string | null

Complemento do endereço, utilizado para informações adicionais. Exemplo: Casa, Sala 402, Apartamento 101, Bloco 2, etc.

Observação:

• O complemento do endereço pode ter no máximo 50 caracteres.

dadosEndereco. cidade · string | null

Cidade do endereço.*

Observação:

• A cidade do endereço pode ter no máximo 40 caracteres.

dadosEndereco. uf · string | null

Sigla do estado (UF) do endereço.*

Observação:

• A sigla do estado (UF) pode ter no máximo 2 caracteres.

dadosEndereco. tipoEndereco · enum<integer>

Tipo de endereço.*

Valores: 1 - Residencial 2 - Trabalho

Available options: 1, 2

dadosEndereco. tipoResidencia · enum<integer>

Tipo de residência.

Valores: 1 - Alugada 2 - Propria 3 - Financiada 4 - CasaFuncional

Available options: 1, 2, 3, 4

dadosEndereco. enderecoDesde · string<date-time> | null

Data de início da residência no endereço.

dadosEndereco. enderecoPrincipal · boolean | null

Indicador de endereço principal do correntista.*

dadosEndereco. enderecoCorrespondencia · boolean | null

Indicador de endereço de correspondência.*

dadosEndereco. verificadoInLoco · boolean | null

Indicador de endereço verificado no próprio local.

Response

200

application/json

Success

sucesso · boolean

mensagem · string | null