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

# Eliminar una cuenta virtual

Desactivar permanentemente una cuenta virtual. Esta operación impide que la cuenta reciba pagos futuros, pero se conservan todos sus registros históricos y datos de transacciones para fines de cumplimiento y conciliación.

**Importante:** Esta acción es irreversible. Una cuenta eliminada no se puede reactivar. Si necesitas reanudar el cobro de pagos para el mismo beneficiario, debes crear una nueva cuenta virtual.


## OpenAPI

````yaml openapi/es/localpayment.json DELETE /api/virtual-account/{externalId}
openapi: 3.1.0
info:
  version: '1.0'
  title: Localpayment
  contact:
    name: Support
    url: mailto:support@localpayment.com
servers:
  - url: https://api.stage.localpayment.com
    description: Stage
security:
  - token: []
paths:
  /api/virtual-account/{externalId}:
    delete:
      summary: Eliminar una cuenta virtual
      operationId: delete-virtual-account
      parameters:
        - name: Authorization
          in: header
          description: >-
            Token de acceso Bearer para la autenticación. Este token se obtiene
            de los endpoints [Get Access Token](/es/reference/get-token) o
            [Refresh Access Token](/es/reference/refresh-token).
          required: true
          schema:
            type: string
        - name: externalId
          in: path
          description: >-
            El identificador único de la cuenta virtual que deseas administrar.
            Debe coincidir exactamente con el valor de externalId que
            proporcionaste al crear la cuenta. Utiliza este identificador para
            especificar la cuenta de destino para operaciones como consultar su
            estado o eliminarla.
          required: true
          schema:
            type: string
            pattern: '[a-zA-Z0-9\- ]+'
            examples:
              - 9c590364-b6b4-116b-cf09-d63e8681c8fc
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  currency:
                    type: string
                    enum:
                      - ARS
                      - BRL
                      - CLP
                      - USD
                      - MXN
                      - PEN
                    description: '[Códigos de moneda](/es/reference/currency-codes).'
                  externalId:
                    type: string
                    description: >-
                      El identificador único de la cuenta virtual. Este es el
                      mismo externalId que proporcionaste en tu solicitud, lo
                      que confirma que la desactivación se realizó en la cuenta
                      correcta.
                  internalId:
                    type: string
                    description: Identificador de transacción de Localpayment.
                  accountNumber:
                    type: string
                    description: Número de cuenta de Localpayment.
                  beneficiary:
                    type: object
                    title: beneficiary
                    description: "La persona o entidad que recibirá los fondos depositados en esta cuenta virtual. El beneficiario es quien recibe el dinero en última instancia y no necesariamente es el propietario o titular legal de la cuenta virtual.\r\n"
                    properties:
                      type:
                        type: string
                        enum:
                          - COMPANY
                          - INDIVIDUAL
                        description: Tipo de beneficiario.
                      name:
                        type: string
                        description: Nombre del beneficiario.
                      document:
                        type: object
                        description: Documentación del beneficiario.
                        properties:
                          type:
                            type: string
                            description: >-
                              El tipo de [documento de
                              identidad](/es/reference/identity-document-types),
                              como el Número de Identidad Nacional, el Número de
                              la Seguridad Social o el Permiso de Conducir,
                              según el país de expedición.
                            examples:
                              - RUC
                          id:
                            type: string
                            description: >-
                              Número de documento de identidad (generalmente un
                              número). Este debe ser un número válido según las
                              normas del tipo de documento específico.
                            examples:
                              - '1791234561009'
                        examples:
                          - type: RUC
                            id: '1791234561009'
                      lastName:
                        type: string
                        description: Apellido del beneficiario.
                      fullName:
                        type: string
                        description: Nombre completo del beneficiario.
                      bank:
                        type: object
                        properties:
                          branch:
                            type: object
                            description: Detalles de la sucursal bancaria.
                            properties:
                              code:
                                type: string
                                description: Código de sucursal.
                          account:
                            type: object
                            description: Datos de la cuenta bancaria del beneficiario.
                            properties:
                              number:
                                type: string
                                description: Número de cuenta.
                              aliases:
                                type: array
                                description: >-
                                  Conjunto de alias de la cuenta (por ejemplo,
                                  identificadores únicos de la cuenta).
                                items:
                                  type: object
                                  properties:
                                    type:
                                      type: string
                                      description: >-
                                        El tipo de alias (p. ej.,
                                        `RandomKeyCode`).
                                    value:
                                      type: string
                                      description: Valor del alias.
                              owner:
                                type: object
                                description: >-
                                  Detalles del documento del titular de la
                                  cuenta.
                                properties:
                                  document:
                                    type: object
                    examples:
                      - type: COMPANY
                        name: string
                        document:
                          type: RUC
                          id: '1791234561009'
                        lastName: string
                        fullName: string
                        bank:
                          branch: {}
                          account:
                            number: string
                            aliases:
                              - type: string
                                value: string
                            owner:
                              document: {}
                  status:
                    $ref: '#/components/schemas/status'
                  errors:
                    type: array
                    description: >-
                      Conjunto de errores que se produjeron durante la
                      transacción. Si la transacción fue exitosa, este conjunto
                      estará vacío.
                    items:
                      type: object
                x-examples:
                  Example 1:
                    currency: MXN
                    externalId: a79aacec-d616-4d84-8abe-be2dcd2e07a1
                    internalId: d710812c-803f-4b65-8e62-7f83eeba321a
                    accountNumber: '{{accountNumber}}'
                    beneficiary:
                      type: INDIVIDUAL
                      name: FirtName
                      document:
                        type: RFC
                        id: EXTF900101NI1
                      bank:
                        branch: {}
                        account:
                          number: '646011319800023790'
                          aliases: []
                          owner:
                            document: {}
                      fullName: FirtName LastName
                      lastName: LastName
                    status:
                      code: '100'
                      description: INPROGRESS
                      detail: Virtual account in progress
                    errors: []
              examples:
                100 - Virtual account in progress:
                  value:
                    currency: MXN
                    externalId: a79aabec-16c6-4a84-8abe-be2dcd2e07a1
                    internalId: d710312c-8c3f-4b65-8e62-7f83eeba321a
                    accountNumber: '{{yourLocalpaymentAccountNumber}}'
                    beneficiary:
                      type: INDIVIDUAL
                      name: Zhang
                      document:
                        type: RFC
                        id: EXTF900101NI1
                      bank:
                        branch: {}
                        account:
                          number: '646011319800023123'
                          aliases: []
                          owner:
                            document: {}
                      fullName: Zhang Wei
                      lastName: Wei
                    status:
                      code: '100'
                      description: INPROGRESS
                      detail: Virtual account in progress
                    errors: []
        '400':
          description: Solicitud incorrecta.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: object
                    properties:
                      code:
                        type: string
                        description: Código de estado.
                      detail:
                        type: string
                        description: Detalles adicionales de la respuesta.
                    required:
                      - code
                      - detail
                required:
                  - status
                x-examples:
                  Example 1:
                    status:
                      code: '400'
                      detail: Virtual account not found
              examples:
                400 - Invalid operation.:
                  value:
                    status:
                      code: '400'
                      detail: Invalid operation
                400 - Virtual account not found.:
                  value:
                    status:
                      code: '400'
                      detail: Virtual account not found
        '401':
          description: No autorizado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    description: Información adicional sobre la respuesta.
                  code:
                    type: string
                    description: Código de estado.
                  messages:
                    type: array
                    description: Lista de mensajes.
                    items:
                      type: object
                      properties:
                        token_class:
                          type: string
                          description: Clase de token.
                        token_type:
                          type: string
                          description: Tipo de token.
                        message:
                          type: string
                          description: Mensaje con información adicional.
                x-examples:
                  Example 1:
                    detail: Given token not valid for any token type
                    code: token_not_valid
                    messages:
                      - token_class: AccessToken
                        token_type: access
                        message: Token is invalid or expired
              examples:
                401 - Token is invalid or expired:
                  value:
                    detail: Given token not valid for any token type
                    code: token_not_valid
                    messages:
                      - token_class: AccessToken
                        token_type: access
                        message: Token is invalid or expired
      security:
        - token: []
      servers:
        - url: https://api.stage.localpayment.com
          description: Stage
components:
  schemas:
    status:
      type: object
      title: status
      description: Estado de la operación.
      properties:
        code:
          type: string
          description: Código de estado.
        description:
          type: string
          description: Descripción del estado.
        detail:
          type: string
          description: Información de estado adicional.
  securitySchemes:
    token:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.