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

# Habilitar o deshabilitar una cuenta virtual

Este endpoint te permite habilitar o deshabilitar temporalmente una cuenta virtual. Utilízalo para suspender la recepción de nuevos fondos en una cuenta específica (deshabilitar) o para reactivarla de modo que pueda volver a aceptar pagos (habilitar). Esto es útil para gestionar las cuentas de los clientes durante revisiones de cumplimiento, pausar suscripciones u otros controles operativos.


## OpenAPI

````yaml openapi/es/localpayment.json PUT /api/virtual-account/{externalId}/activation/{status}/
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}/activation/{status}/:
    put:
      summary: Habilitar o deshabilitar una cuenta virtual
      operationId: update-virtual-account-status
      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: status
          in: path
          description: '`enable` o `disable`.'
          required: true
          schema:
            type: string
            enum:
              - enable
              - disable
            examples:
              - enable
        - 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 habilitarla o
            deshabilitarla.
          required: true
          schema:
            type: string
            pattern: '[a-zA-Z0-9\- ]+'
            examples:
              - 53025bf4-4c87-4b4f-8fea-b47004440f37
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  currency:
                    type: string
                    enum:
                      - ARS
                      - BRL
                      - CLP
                      - USD
                      - MXN
                      - PEN
                    description: '[código 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 operació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:
                    type: object
                    title: status
                    description: Estado de la operación.
                    properties:
                      code:
                        type: string
                        description: >-
                          [Código de
                          estado](/es/reference/validate-identity-document).
                      description:
                        type: string
                        description: >-
                          [Descripción del
                          estado](/es/reference/validate-identity-document).
                      detail:
                        type: string
                        description: Información de estado adicional.
                  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: e36ef959-12d4-4cf0-b00c-99dc51798f4b
                    internalId: c09095fb-6a0e-47ff-9143-9d9452b0f290
                    accountNumber: '{{accountNumber}}'
                    beneficiary:
                      type: INDIVIDUAL
                      name: FirtName
                      document:
                        type: RFC
                        id: EXTF900101NI1
                      bank:
                        branch: {}
                        account:
                          number: '646011319800023800'
                          aliases: []
                          owner:
                            document: {}
                      fullName: FirtName LastName
                      lastName: LastName
                    status:
                      code: '200'
                      description: COMPLETED
                      detail: Virtual account has been created
                    errors: []
              examples:
                200 - Virtual account has been created.:
                  value:
                    currency: MXN
                    externalId: e36ef929-c2d4-fcf0-b30c-99dc51798f4b
                    internalId: c09095fb-6a0e-47af-9f43-3d9452b0f290
                    accountNumber: '{{yourLocalpaymentAccountNumber}}'
                    beneficiary:
                      type: INDIVIDUAL
                      name: John
                      document:
                        type: RFC
                        id: EXTF900101NI1
                      bank:
                        branch: {}
                        account:
                          number: '646011319800023123'
                          aliases: []
                          owner:
                            document: {}
                      fullName: John Doe
                      lastName: Doe
                    status:
                      code: '200'
                      description: COMPLETED
                      detail: Virtual account has been created
                    errors: []
                300 - Virtual account disabled.:
                  value:
                    currency: MXN
                    externalId: e36eff59-22d4-ccf0-bf0c-99dc51798f4b
                    internalId: c09095fb-6a4e-17cf-9343-9d9452b0f290
                    accountNumber: '{{yourLocalpaymentAccountNumber}}'
                    beneficiary:
                      type: INDIVIDUAL
                      name: John
                      document:
                        type: RFC
                        id: EXTF900101NI1
                      bank:
                        branch: {}
                        account:
                          number: '646011319800023123'
                          aliases: []
                          owner:
                            document: {}
                      fullName: John Doe
                      lastName: Doe
                    status:
                      code: '300'
                      description: DISABLED
                      detail: Virtual account disabled
                    errors: []
        '400':
          description: Solicitud incorrecta.
          content:
            application/json:
              schema:
                type: object
                properties:
                  timestamp:
                    type: string
                    description: Tiempo de ejecución del servicio.
                  status:
                    type: integer
                    description: Código de estado del error.
                  error:
                    type: string
                    description: Descripción del error.
                  message:
                    type: string
                    description: Mensaje con información adicional.
                  path:
                    type: string
                    description: Ruta del servicio.
                x-examples:
                  Example 1:
                    timestamp: '2025-01-06T23:55:22.121+00:00'
                    status: 400
                    error: Bad Request.
                    message: >-
                      Status activation not recognize. Please use 'disable' or
                      'enable'
                    path: >-
                      /virtual-account/e36ef959-12d4-4cf0-b00c-99dc51798f4b/activation/:status
              examples:
                400 - Status activation not recognize.:
                  value:
                    timestamp: '2025-01-06T23:55:22.121+00:00'
                    status: 400
                    error: Bad Request.
                    message: >-
                      Status activation not recognize. Please use 'disable' or
                      'enable'
                    path: >-
                      /virtual-account/e36ef159-b2d4-4af0-b02c-99dc51798f4b/activation/:status
                400 - Virtual Account doesn't exist.:
                  value:
                    timestamp: '2025-01-07T00:03:14.639+00:00'
                    status: 400
                    error: Bad Request.
                    message: Virtual Account doesn't exist
                    path: >-
                      /virtual-account/e36ef959-12d4-4cf0-b00c-99dc51798f4b2/activation/disable
        '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:
  securitySchemes:
    token:
      type: http
      scheme: bearer

````

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