> ## Documentation Index
> Fetch the complete documentation index at: https://bmpdocs.moneyp.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# 45 - Create Account

> <p>Scopes:</p>
<b>api.ext api.conta.criar</b>

Through this endpoint, the partner can open an account under the integrator's domain.


## OpenAPI

````yaml post /api/v2/Conta
openapi: 3.0.1
info:
  title: BMPSPBExt
  description: '<p><strong>Build Number: </strong>#0.0</p>'
  version: v1
servers:
  - url: https://api.ext.dbs.moneyp.dev.br/
    description: Localhost
security:
  - Bearer: []
paths:
  /api/v2/Conta:
    post:
      tags:
        - Conta
      summary: Endpoint responsável por criar uma nova conta corrente no sistema.
      description: "<p>Scopes:</p>\r\n<b>api.ext api.conta.criar</b>"
      parameters:
        - name: IdempotencyKey
          in: header
          required: true
          schema:
            type: string
        - name: IgnoraHandshake
          in: header
          description: (somente em homologação)
          required: true
          schema:
            type: boolean
            default: true
      requestBody:
        content:
          application/json:
            schema:
              allOf:
                - $ref: >-
                    #/components/schemas/BMPSPB.Domain.Messaging.API.Externa.Conta.CriacaoContaV2Request
          text/json:
            schema:
              allOf:
                - $ref: >-
                    #/components/schemas/BMPSPB.Domain.Messaging.API.Externa.Conta.CriacaoContaV2Request
          application/*+json:
            schema:
              allOf:
                - $ref: >-
                    #/components/schemas/BMPSPB.Domain.Messaging.API.Externa.Conta.CriacaoContaV2Request
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/BMPSPB.Domain.Messaging.API.Externa.Conta.CriacaoContaResponse
        '400':
          description: Erro de negócio
          content:
            application/json:
              schema:
                type: object
                properties:
                  sucesso:
                    type: boolean
                  mensagem:
                    type: string
        '500':
          description: Erro interno do servidor
          content:
            application/json:
              schema:
                type: object
                properties:
                  sucesso:
                    type: boolean
                  mensagem:
                    type: string
components:
  schemas:
    BMPSPB.Domain.Messaging.API.Externa.Conta.CriacaoContaV2Request:
      type: object
      properties:
        numeroBanco:
          type: string
          description: >-
            Número do banco.*


            Observação:

            - O 'número do banco' (```numeroBanco```) pode ter no máximo 3
            caracteres.
          nullable: true
        numeroAgencia:
          type: string
          description: |-
            Número da agência.*

            Observação:
            - O número da agência pode ter no máximo 4 caracteres.
            - Valor padrão: '0001'
          nullable: true
        numeroConta:
          type: string
          description: >-
            Número da conta bancária.


            Observações:

            - O 'número da conta' (```numeroConta```) é obrigatório quando o
            'tipo de geração' (```tipoGeracaoNumeroConta```) informado for 0
            (manual).

            - O 'número da conta' (```numeroConta```) não deve ser informado
            quando o 'tipo de geração' (```tipoGeracaoNumeroConta```) informado
            for 1 (sequencial).

            - O número da conta bancária pode ter no máximo 12 caracteres.
          nullable: true
        digitoConta:
          type: string
          description: >-
            Dígito verificador do número da conta bancária.


            Observação:

            - O dígito verificador do número da conta bancária pode ter no
            máximo 1 caracter.
          nullable: true
        descricao:
          type: string
          description: Informações adicionais sobre a conta.
          nullable: true
        tipoGeracaoNumeroConta:
          allOf:
            - $ref: '#/components/schemas/BMPSPB.Infra.Enums.TipoGeracaoConta'
          description: |-
            Tipo de geração de conta.*

            Observação:
            - Valor padrão: '0'

            Valores:
            0 - Manual
            1 - Sequencial
        modCobrTaxa:
          allOf:
            - $ref: '#/components/schemas/BMPSPB.Infra.Enums.ModeloCobrancaTaxa'
          description: |-
            Modelo de cobrança de taxa.*

            Observação:
            - Valor padrão: '1'

            Valores:
            0 - Desativado
            1 - Parceiro
            1 - Cliente
          nullable: true
        tipoConta:
          type: integer
          description: |-
            Tipo de conta.*

            Observação:
            - Valor padrão: '3'

            Valores:
            -1 - CACC
            2 - SVGS
            3 - TRAN
            4 - SLRY
          format: int32
        dadosCorrentista:
          allOf:
            - $ref: >-
                #/components/schemas/BMPSPB.Domain.Messaging.API.Externa.Correntista.CorrentistaRequest
          description: Objeto detalhado da identificação do correntista vinculado à conta.*
          nullable: true
        dadosContato:
          allOf:
            - $ref: >-
                #/components/schemas/BMPSPB.Domain.Messaging.API.Shared.Correntista.CorrentistaDadosContatoRequest
          description: Objeto detalhado do contato do correntista vinculado à conta.*
          nullable: true
        dadosEndereco:
          allOf:
            - $ref: >-
                #/components/schemas/BMPSPB.Domain.Messaging.API.Shared.Correntista.CorrentistaEnderecoRequest
          description: Objeto detalhado do endereço do correntista vinculado à conta.
          nullable: true
        dadosPF:
          allOf:
            - $ref: >-
                #/components/schemas/BMPSPB.Domain.Messaging.API.Shared.Correntista.CorrentistaPFRequest
          description: >-
            Objeto detalhado dos dados de pessoa física do correntista vinculado
            à conta.


            Observação:

            - Quando o 'tipo de pessoa do correntista' (```tipoPessoa```) for 1
            (PF), este objeto deve ser preenchido.
          nullable: true
        dadosPJ:
          allOf:
            - $ref: >-
                #/components/schemas/BMPSPB.Domain.Messaging.API.Shared.Correntista.CorrentistaPJRequest
          description: >-
            Objeto detalhado dos dados de pessoa jurídica do correntista
            vinculado à conta.


            Observação:

            - Quando o 'tipo de pessoa do correntista' (```tipoPessoa```) for 2
            (PJ), este objeto deve ser preenchido.
          nullable: true
        modeloConta:
          allOf:
            - $ref: '#/components/schemas/BMPSPB.Infra.Enums.ModeloConta'
      additionalProperties: false
    BMPSPB.Domain.Messaging.API.Externa.Conta.CriacaoContaResponse:
      type: object
      properties:
        sucesso:
          type: boolean
        mensagem:
          type: string
          nullable: true
        numero:
          type: string
          nullable: true
        digito:
          type: string
          nullable: true
        contaPagamento:
          type: string
          nullable: true
      additionalProperties: false
    BMPSPB.Infra.Enums.TipoGeracaoConta:
      enum:
        - 0
        - 1
      type: integer
      description: ''
      format: int32
    BMPSPB.Infra.Enums.ModeloCobrancaTaxa:
      enum:
        - 0
        - 1
        - 2
      type: integer
      description: ''
      format: int32
    BMPSPB.Domain.Messaging.API.Externa.Correntista.CorrentistaRequest:
      type: object
      properties:
        documentoFederal:
          type: string
          description: >-
            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.
          nullable: true
        nome:
          type: string
          description: |-
            Nome completo do correntista.*

            Observação:
            - O nome do correntista pode ter no máximo 100 caracteres.
          nullable: true
        tipoPessoa:
          type: integer
          description: |-
            Tipo de pessoa.

            Valores:
            1 - PF
            2 - PJ
          format: int32
        situacao:
          allOf:
            - $ref: '#/components/schemas/BMPSPB.Infra.Enums.Situacao'
          description: |-
            Situacao.

            Valores:
            1 - Ativado
            2 - Desativado
          nullable: true
      additionalProperties: false
    BMPSPB.Domain.Messaging.API.Shared.Correntista.CorrentistaDadosContatoRequest:
      type: object
      properties:
        email:
          type: string
          description: >-
            Email de contato do correntista.*


            Observação:

            - O email de contato do correntista pode ter no máximo 60
            caracteres.
          nullable: true
        telefoneFixo1:
          type: string
          description: >-
            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.
          nullable: true
        telefoneFixo2:
          type: string
          description: >-
            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.
          nullable: true
        telefoneCelular1:
          type: string
          description: >-
            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.
          nullable: true
        telefoneCelular2:
          type: string
          description: >-
            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.
          nullable: true
        telefoneFax:
          type: string
          description: >-
            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.
          nullable: true
        paginaWeb:
          type: string
          description: >-
            URL da página web do correntista.


            Observação:

            - A URL da página web do correntista pode ter no máximo 255
            caracteres.
          nullable: true
      additionalProperties: false
    BMPSPB.Domain.Messaging.API.Shared.Correntista.CorrentistaEnderecoRequest:
      type: object
      properties:
        cep:
          type: string
          description: >-
            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.
          nullable: true
        logradouro:
          type: string
          description: >-
            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.
          nullable: true
        nroLogradouro:
          type: string
          description: |-
            Número do endereço.*

            Observação:
            - O número do endereço pode ter no máximo 15 caracteres.
          nullable: true
        bairro:
          type: string
          description: |-
            Bairro do endereço.

            Observação:
            - O bairro do endereço pode ter no máximo 50 caracteres.
          nullable: true
        complemento:
          type: string
          description: >-
            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.
          nullable: true
        cidade:
          type: string
          description: |-
            Cidade do endereço.*

            Observação:
            - A cidade do endereço pode ter no máximo 40 caracteres.
          nullable: true
        uf:
          type: string
          description: |-
            Sigla do estado (UF) do endereço.*

            Observação:
            - A sigla do estado (UF) pode ter no máximo 2 caracteres.
          nullable: true
        tipoEndereco:
          allOf:
            - $ref: '#/components/schemas/BMPSPB.Infra.Enums.TipoEndereco'
          description: |-
            Tipo de endereço.*

            Valores:
            1 - Residencial
            2 - Trabalho
          nullable: true
        tipoResidencia:
          allOf:
            - $ref: '#/components/schemas/BMPSPB.Infra.Enums.TipoResidencia'
          description: |-
            Tipo de residência.

            Valores:
            1 - Alugada
            2 - Propria
            3 - Financiada
            4 - CasaFuncional
          nullable: true
        enderecoDesde:
          type: string
          description: Data de início da residência no endereço.
          format: date-time
          nullable: true
        enderecoPrincipal:
          type: boolean
          description: Indicador de endereço principal do correntista.*
          nullable: true
        enderecoCorrespondencia:
          type: boolean
          description: Indicador de endereço de correspondência.*
          nullable: true
        verificadoInLoco:
          type: boolean
          description: Indicador de endereço verificado no próprio local.
          nullable: true
      additionalProperties: false
    BMPSPB.Domain.Messaging.API.Shared.Correntista.CorrentistaPFRequest:
      type: object
      properties:
        apelido:
          type: string
          description: >-
            Identificação personalizada para o correntista.


            Observação:

            - A identificação personalizada para o correntista pode ter no
            máximo 50 caracteres.
          nullable: true
        rg:
          type: string
          description: |-
            Número do registro geral (RG).

            Observação:
            - O número do registro geral (RG) pode ter no máximo 20 caracteres.
          nullable: true
        rgOrgao:
          type: string
          description: |-
            Orgão Emissor do RG.

            Observação:
            - O orgão emissor do RG pode ter no máximo 10 caracteres.
          nullable: true
        rguf:
          type: string
          description: >-
            Sigla do estado (UF) da emissão do RG


            Observação:

            - A sigla do estado (UF) da emissão do RG pode ter no máximo 2
            caracteres.
          nullable: true
        rgData:
          type: string
          description: Data de expedição do RG.
          format: date-time
          nullable: true
        dtNasc:
          type: string
          description: Data de nascimento.
          format: date-time
          nullable: true
        sexo:
          type: string
          description: |-
            Sexo do correntista.

            Observações:
            - F = Feminino, M = Masculino.
            - O sexo do correntista pode ser 'F' (feminino) ou 'M' (masculino).
          nullable: true
        nacionalidade:
          type: string
          description: |-
            Pais de origem ou cidadania.

            Observação:
            - O país de origem ou cidadania pode ter no máximo 40 caracteres.
          nullable: true
        naturalDeCidade:
          type: string
          description: |-
            Cidade de nascimento.

            Observação:
            - A cidade de nascimento pode ter no máximo 40 caracteres.
          nullable: true
        naturalDeUF:
          type: string
          description: >-
            Sigla do estado (UF) de nascimento.


            Observação:

            - A sigla do estado (UF) de nascimento pode ter no máximo 2
            caracteres.
          nullable: true
        estadoCivil:
          allOf:
            - $ref: '#/components/schemas/BMPSPB.Infra.Enums.EstadoCivil'
          description: |-
            Estado civil.

            Valores:
            1 - Solteiro
            2 - Casado
            3 - Desquitado
            4 - Divorciado
            5 - Separado
            6 - Viuvo
            7 - Outros
            8 - Nao Informado
            9 - Vinculo Conjugal
          nullable: true
        escolaridade:
          allOf:
            - $ref: '#/components/schemas/BMPSPB.Infra.Enums.Escolaridade'
          description: |-
            Escolaridade.

            Valores:
            1 - Cursando Educação Infantil
            2 - Educação Infantil Completa
            3 - Cursando Ensino Fundamental
            4 - Ensino Fundamental Completo
            5 - Cursando Ensino Médio
            6 - Ensino Médio Completo
            7 - Cursando Ensino Superior
            8 - Ensino Superior Completo
            9 - Cursando Especialização
            10 - Especialização Completa
            11 - Cursando Mestrado
            12 - Mestrado Completo
            13 - Cursando Doutorado
            14 - Doutorado Completo
            15 - Cursando Pos Doutorado
            16 - PosDoutorado Completo
            17 - Analfabeto
            18 - Sem Instrução Escola
          nullable: true
        nomePai:
          type: string
          description: |-
            Nome completo do pai.

            Observação:
            - O nome completo do pai pode ter no máximo 60 caracteres.
          nullable: true
        nomeMae:
          type: string
          description: |-
            Nome completo da mãe.

            Observação:
            - O nome completo da mãe pode ter no máximo 60 caracteres.
          nullable: true
        nomeConjuge:
          type: string
          description: |-
            Nome completo do conjuge.

            Observação:
            - O nome completo do conjuge pode ter no máximo 60 caracteres.
          nullable: true
        dtNascConjuge:
          type: string
          description: Data de nascimento do cônjuge.
          format: date-time
          nullable: true
        cpfConjuge:
          type: string
          description: >-
            Número do CPF do cônjuge.


            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 CPF do cônjuge pode ter no máximo 11 caracteres.
          nullable: true
        rgConjuge:
          type: string
          description: |-
            Número do RG do cônjuge.

            Observação:
            - O número do RG do cônjuge pode ter no máximo 20 caracteres.
          nullable: true
        rgOrgaoConjuge:
          type: string
          description: |-
            Orgão emissor do RG do cônjuge.

            Observação:
            - O orgão emissor do RG do cônjuge pode ter no máximo 10 caracteres.
          nullable: true
        rgufConjuge:
          type: string
          description: >-
            Sigla do estado (UF) do RG do cônjuge.


            Observação:

            - A sigla do estado (UF) do RG do cônjuge pode ter no máximo 2
            caracteres.
          nullable: true
        rgDataConjuge:
          type: string
          description: Data de emissão do RG do cônjuge.
          format: date-time
          nullable: true
        nomeArquivoIdentificacao:
          type: string
          description: >-
            Nome do arquivo de identificação do correntista.


            Observação:

            - O nome do arquivo de identificação do correntista pode ter no
            máximo 60 caracteres.
          nullable: true
        arquivoIdentificacao:
          type: string
          description: A arquivo de identificação do correntista em string base64.
          nullable: true
        indicadorPEP:
          allOf:
            - $ref: '#/components/schemas/BMPSPB.Infra.Enums.IndicadorPEP'
          description: |-
            Indicador de pessoa políticamente exposta (PEP).

            Valores:
            1 - Sim
            2 - Não
          nullable: true
        renda:
          type: number
          description: Valor da renda mensal do correntista.
          format: double
          nullable: true
        profissao:
          type: string
          description: Profissão do correntista.
          nullable: true
      additionalProperties: false
    BMPSPB.Domain.Messaging.API.Shared.Correntista.CorrentistaPJRequest:
      type: object
      properties:
        nomeFantasia:
          type: string
          description: |-
            Nome comercial pelo qual a empresa é conhecida publicamente.

            Observação:
            - O nome fantasia da empresa pode ter no máximo 60 caracteres.
          nullable: true
        documentoEstadual:
          type: string
          description: >-
            Número de registro estadual da empresa.


            Observação:

            - O número de registro estadual da empresa pode ter no máximo 20
            caracteres.
          nullable: true
        documentoMunicipal:
          type: string
          description: >-
            Número de registro municipal da empresa.


            Observação:

            - O número de registro municipal da empresa pode ter no máximo 20
            caracteres.
          nullable: true
        dtAberturaEmpresa:
          type: string
          description: Data de abertura da empresa.
          format: date-time
          nullable: true
        nomeResponsavelEmpresa:
          type: string
          description: >-
            Nome do responsável pela empresa.


            Observação:

            - O nome do responsável pela empresa pode ter no máximo 60
            caracteres.
          nullable: true
        cpfResponsavelEmpresa:
          type: string
          description: >-
            Nº do CPF do responsável pela empresa.


            Observações:

            - Informar apenas os números do documento sem os caracteres de
            formatação (exemplo: ponto, traço, barra, etc.).

            - O nº do CPF do responsável pela empresa pode ter no máximo 11
            caracteres.
          nullable: true
        rgResponsavelEmpresa:
          type: string
          description: >-
            Nº do RG do responsável pela empresa.


            Observação:

            - O nº do RG do responsável pela empresa pode ter no máximo 20
            caracteres.
          nullable: true
        nomeArquivoContratoSocial:
          type: string
          description: Nome do arquivo do contrato social da empresa.
          nullable: true
        arquivoContratoSocial:
          type: string
          description: Arquivo do contrato social da empresa em string base64.
          nullable: true
        capitalSocial:
          type: number
          description: Valor do capital social da empresa.
          format: double
          nullable: true
        faturamentoAnual:
          type: number
          description: Valor do faturamento anual da empresa.
          format: double
          nullable: true
        tipoEmpresa:
          allOf:
            - $ref: '#/components/schemas/BMPSPB.Infra.Enums.TipoDocumentoEmpresa'
          description: |-
            Tipo de documento da empresa.

            Valores:
            1 - MEI
            2 - Empresário Individual
            3 - Sociedade Limitada Unipessoal
            4 - Sociedade Empresária Limitada
            5 - Sociedade Simples
            6 - Sociedade Anônima
            7 - Sociedade Cooperativa
            8 - Sociedade de Associação Privada
            9 - Condomínio Edifício
          nullable: true
        codigoCnae:
          type: string
          description: Código CNAE da empresa conforme cadastro interno da BMP.
          format: uuid
          nullable: true
      additionalProperties: false
    BMPSPB.Infra.Enums.ModeloConta:
      enum:
        - 1
        - 2
        - 3
      type: integer
      description: ''
      format: int32
    BMPSPB.Infra.Enums.Situacao:
      enum:
        - 1
        - 2
      type: integer
      description: ''
      format: int32
    BMPSPB.Infra.Enums.TipoEndereco:
      enum:
        - 1
        - 2
      type: integer
      description: ''
      format: int32
    BMPSPB.Infra.Enums.TipoResidencia:
      enum:
        - 1
        - 2
        - 3
        - 4
      type: integer
      description: ''
      format: int32
    BMPSPB.Infra.Enums.EstadoCivil:
      enum:
        - 1
        - 2
        - 3
        - 4
        - 5
        - 6
        - 7
        - 8
        - 9
      type: integer
      description: ''
      format: int32
    BMPSPB.Infra.Enums.Escolaridade:
      enum:
        - 1
        - 2
        - 3
        - 4
        - 5
        - 6
        - 7
        - 8
        - 9
        - 10
        - 11
        - 12
        - 13
        - 14
        - 15
        - 16
        - 17
        - 18
      type: integer
      description: ''
      format: int32
    BMPSPB.Infra.Enums.IndicadorPEP:
      enum:
        - 1
        - 2
      type: integer
      description: ''
      format: int32
    BMPSPB.Infra.Enums.TipoDocumentoEmpresa:
      enum:
        - 1
        - 2
        - 3
        - 4
        - 5
        - 6
        - 7
        - 8
        - 9
      type: integer
      description: ''
      format: int32
  securitySchemes:
    Bearer:
      type: apiKey
      description: Copie 'Bearer ' + token
      name: Authorization
      in: header

````