> ## 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.

# 43 - Account Closure Request

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

Through this endpoint, the partner can request the closure of an account at bank 274.

Account closures, before being effectively executed in the system, undergo an analysis by the bank's operators, who will proceed with the closure request.


## OpenAPI

````yaml post /api/Conta/Encerramento
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/Conta/Encerramento:
    post:
      tags:
        - Conta
      summary: >-
        Endpoint responsável por processar a solicitação de encerramento de uma
        conta bancária.
      description: "<p>Scopes:</p>\r\n<b>api.ext api.conta.encerrar</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.SolicitaEncerramentoRequest
          text/json:
            schema:
              allOf:
                - $ref: >-
                    #/components/schemas/BMPSPB.Domain.Messaging.API.Externa.Conta.SolicitaEncerramentoRequest
          application/*+json:
            schema:
              allOf:
                - $ref: >-
                    #/components/schemas/BMPSPB.Domain.Messaging.API.Externa.Conta.SolicitaEncerramentoRequest
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/BMPSPB.Domain.Messaging.API.Shared.SolicitacaoEncerramentoResponse
        '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.SolicitaEncerramentoRequest:
      type: object
      properties:
        conta:
          allOf:
            - $ref: >-
                #/components/schemas/BMPSPB.Domain.Messaging.API.Shared.Conta.ContaDto
          description: Objeto detalhado da conta bancária.*
          nullable: true
        motivoEncerramento:
          allOf:
            - $ref: '#/components/schemas/BMPSPB.Infra.Enums.MotivoEncerramento'
          description: |-
            Motivo de encerramento da conta.*

            Valores:
            -1 - Encerramento por desinteresse comercial
            2 - Encerramento a pedido do titular da conta
            3 - Encerramento prevenção a fraude
            4 - Encerramento solicitado pelo Comitê Compliance
            5 - Encerramento por decisão judicial
            6 - Encerramento por cancelamento de operação
            7 - Encerramento por cobrança de tarifa
            8 - Encerramento por não reconhecimento de conta pagamento
            9 - Encerramento por falta de atendimento
            10 - Outros
            11 - Encerramento a pedido do parceiro
        complementoEncerramento:
          type: string
          description: >-
            Informações complementares do encerramento da conta.


            Observação:

            - As informações complementares de encerramento da conta podem ter
            no máximo 200 caracteres.
          nullable: true
      additionalProperties: false
    BMPSPB.Domain.Messaging.API.Shared.SolicitacaoEncerramentoResponse:
      type: object
      properties:
        codigo:
          type: string
          format: uuid
        motivoEncerramento:
          allOf:
            - $ref: '#/components/schemas/BMPSPB.Infra.Enums.MotivoEncerramento'
        complementoEncerramento:
          type: string
          nullable: true
        situacao:
          allOf:
            - $ref: >-
                #/components/schemas/BMPSPB.Infra.Enums.SituacaoSolicitacaoEncerramentoConta
        motivoRejeicao:
          type: string
          nullable: true
        dtInclusao:
          type: string
          format: date-time
      additionalProperties: false
    BMPSPB.Domain.Messaging.API.Shared.Conta.ContaDto:
      type: object
      properties:
        agencia:
          type: string
          description: |-
            Número da agência bancária.*

            Observações:
            - O número da agência pode ter no máximo 4 caracteres.
          nullable: true
        agenciaDigito:
          type: string
          description: >-
            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.
          nullable: true
        conta:
          type: string
          description: >-
            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.
          nullable: true
        contaDigito:
          type: string
          description: >-
            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.
          nullable: true
        contaPgto:
          type: string
          description: >-
            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.
          nullable: true
        tipoConta:
          allOf:
            - $ref: '#/components/schemas/BMPSPB.Infra.Enums.TipoConta'
          description: |-
            Tipo da conta.*

            Valores:
            1 - Corrente
            2 - Poupanca
            3 - Pagamento
            4 - Salario
          nullable: true
        modeloConta:
          allOf:
            - $ref: '#/components/schemas/BMPSPB.Infra.Enums.ModeloConta'
          description: |-
            Modelo da conta.*

            Valores:
            1 - Movimento
            2 - Escrow
            3 - Vinculada
          nullable: true
      additionalProperties: false
    BMPSPB.Infra.Enums.MotivoEncerramento:
      enum:
        - 1
        - 2
        - 3
        - 4
        - 5
        - 6
        - 7
        - 8
        - 9
        - 10
        - 11
      type: integer
      description: ''
      format: int32
    BMPSPB.Infra.Enums.SituacaoSolicitacaoEncerramentoConta:
      enum:
        - 1
        - 2
        - 3
        - 4
        - 5
      type: integer
      description: ''
      format: int32
    BMPSPB.Infra.Enums.TipoConta:
      enum:
        - 1
        - 2
        - 3
        - 4
      type: integer
      description: ''
      format: int32
    BMPSPB.Infra.Enums.ModeloConta:
      enum:
        - 1
        - 2
        - 3
      type: integer
      description: ''
      format: int32
  securitySchemes:
    Bearer:
      type: apiKey
      description: Copie 'Bearer ' + token
      name: Authorization
      in: header

````