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

# Crear cuentas virtuales en lote

Este endpoint permite crear varias cuentas virtuales simultáneamente, lo que agiliza el proceso de creación de cuentas al gestionar un gran número de ellas. Se pueden crear entre 10 y 5000 cuentas virtuales mediante una matriz.


## OpenAPI

````yaml openapi/es/localpayment.json POST /api/virtual-account-batch
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-batch:
    post:
      summary: Crear cuentas virtuales en lote
      operationId: request-batch
      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
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                externalId:
                  type: string
                  description: >-
                    Un identificador único que tú proporcionas para todo este
                    proceso por lotes. Este ID se utilizará para realizar el
                    seguimiento y la referencia de la operación por lotes en su
                    conjunto.
                accountNumber:
                  type: string
                  description: Número de cuenta de Localpayment.
                country:
                  type: string
                  enum:
                    - ARG
                    - BRA
                    - CHL
                    - MEX
                  description: '[País](/es/reference/country-codes). ISO 3166-1 alfa-3.'
                name:
                  type: string
                accounts:
                  type: array
                  items:
                    type: object
                    properties:
                      externalId:
                        type: string
                        description: >-
                          Un identificador único que tú proporcionas para
                          cuentas virtuales específicas dentro del lote. Este ID
                          será la referencia principal de esta cuenta individual
                          en todas las operaciones futuras (por ejemplo,
                          verificar el estado, deshabilitarla).
                      beneficiary:
                        type: object
                        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: >-
                              El nombre del beneficiario. Los caracteres
                              permitidos dependen del campo `type`: para
                              `individual`, letras (incluidos los caracteres
                              acentuados), espacios y puntos (`.`); para
                              `company`, el mismo conjunto más dígitos, guion
                              bajo (`_`) y guion (`-`).
                            minLength: 2
                            maxLength: 255
                          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'
                            required:
                              - type
                              - id
                            examples:
                              - type: RUC
                                id: '1791234561009'
                          lastName:
                            type: string
                            description: >-
                              El apellido del beneficiario. Obligatorio cuando
                              `type` es `individual` y se ignora cuando `type`
                              es `company`. Los caracteres permitidos dependen
                              de `type`: para `individual`, letras (incluidos
                              los caracteres acentuados), espacios y puntos
                              (`.`); para `company`, el mismo conjunto más
                              dígitos, guion bajo (`_`) y guion (`-`).
                            minLength: 2
                            maxLength: 255
                          address:
                            type: object
                            description: Dirección del beneficiario.
                            properties:
                              street:
                                type: string
                                description: Nombre de la calle.
                                examples:
                                  - Independencia
                              number:
                                type: string
                                description: Número de calle.
                                examples:
                                  - '123'
                              city:
                                type: string
                                description: Ciudad.
                                examples:
                                  - Cordoba
                              state:
                                type: string
                                description: Estado.
                                examples:
                                  - Cordoba
                              country:
                                type: string
                                description: País de la dirección.
                                examples:
                                  - Argentina
                              zipCode:
                                type: string
                                description: Código postal.
                                examples:
                                  - X5000IUO
                              comment:
                                type: string
                                description: Información adicional sobre la dirección.
                                examples:
                                  - Sucursal 123
                            examples:
                              - street: Independencia
                                number: '123'
                                city: Cordoba
                                state: Cordoba
                                country: ARG
                                zipCode: X5000IUO
                                comment: Sucursal 123
                        required:
                          - type
                          - name
                          - document
                        examples:
                          - type: INDIVIDUAL
                            name: John
                            document:
                              type: RUC
                              id: '1791234561009'
                            lastName: Doe
                            address:
                              street: Independencia
                              number: '123'
                              city: Cordoba
                              state: Cordoba
                              country: ARG
                              zipCode: X5000IUO
                              comment: Sucursal 123
                    required:
                      - beneficiary
              required:
                - externalId
                - accountNumber
                - country
                - accounts
              x-examples:
                Example 1:
                  externalId: '{{$guid}}'
                  accountNumber: '{{YourAccountNumber}}'
                  country: MEX
                  name: Virtual Account
                  accounts:
                    - externalId: 1111111111-1
                      beneficiary:
                        type: INDIVIDUAL
                        name: BeneficiaryName
                        lastname: BeneficiaryLastname
                        document:
                          id: EXTF900101NI1
                          type: RFC
                        address:
                          city: city
                          state: state
                          zipcode: zipcode
                          street: street
                          number: number
                          country: country
                    - externalId: 1111111111-2
                      beneficiary:
                        type: INDIVIDUAL
                        name: BeneficiaryName
                        lastname: BeneficiaryLastname
                        document:
                          id: EXTF900101NI1
                          type: RFC
                    - externalId: 1111111111-3
                      beneficiary:
                        type: INDIVIDUAL
                        name: BeneficiaryName
                        lastname: BeneficiaryLastname
                        document:
                          id: EXTF900101NI1
                          type: RFC
                        address:
                          city: city
                          state: state
                          zipcode: zipcode
                          street: street
                          number: number
                          country: country
                    - externalId: 1111111111-4
                      beneficiary:
                        type: INDIVIDUAL
                        name: BeneficiaryName
                        lastname: BeneficiaryLastname
                        document:
                          id: EXTF900101NI1
                          type: RFC
                    - externalId: 1111111111-5
                      beneficiary:
                        type: INDIVIDUAL
                        name: BeneficiaryName
                        lastname: BeneficiaryLastname
                        document:
                          id: EXTF900101NI1
                          type: RFC
                        address:
                          city: city
                          state: state
                          zipcode: zipcode
                          street: street
                          number: number
                          country: country
                    - externalId: 1111111111-6
                      beneficiary:
                        type: INDIVIDUAL
                        name: BeneficiaryName
                        lastname: BeneficiaryLastname
                        document:
                          id: EXTF900101NI1
                          type: RFC
                    - externalId: 1111111111-7
                      beneficiary:
                        type: INDIVIDUAL
                        name: BeneficiaryName
                        lastname: BeneficiaryLastname
                        document:
                          type: RFC
                          id: EXTF900101NI1
                        address:
                          city: city
                          state: state
                          zipcode: zipcode
                          street: street
                          number: number
                          country: country
                    - externalId: 1111111111-8
                      beneficiary:
                        type: INDIVIDUAL
                        name: BeneficiaryName
                        lastname: BeneficiaryLastname
                        document:
                          id: EXTF900101NI1
                          type: RFC
                    - externalId: 1111111111-9
                      beneficiary:
                        type: INDIVIDUAL
                        name: BeneficiaryName
                        lastname: BeneficiaryLastname
                        document:
                          id: EXTF900101NI1
                          type: RFC
                        address:
                          city: city
                          state: state
                          zipcode: zipcode
                          street: street
                          number: number
                          country: country
                    - externalId: 1111111111-10
                      beneficiary:
                        type: INDIVIDUAL
                        name: BeneficiaryName
                        lastname: BeneficiaryLastname
                        document:
                          id: EXTF900101NI1
                          type: RFC
                    - externalId: 1111111111-11
                      beneficiary:
                        type: INDIVIDUAL
                        name: BeneficiaryName
                        lastname: BeneficiaryLastname
                        document:
                          id: EXTF900101NI1
                          type: RFC
                        address:
                          city: city
                          state: state
                          zipcode: zipcode
                          street: street
                          number: number
                          country: country
                    - externalId: 1111111111-12
                      beneficiary:
                        type: INDIVIDUAL
                        name: BeneficiaryName
                        lastname: BeneficiaryLastname
                        document:
                          id: EXTF900101NI1
                          type: RFC
                        address:
                          city: city
                          state: state
                          zipcode: zipcode
                          street: street
                          number: number
                          country: country
            examples:
              100 - Batch Process Virtual Account in progress.:
                value:
                  externalId: de14bcf2-45ee-22e3-ab59-99c3fcba31e8
                  accountNumber: '{{yourLocalpaymentAccountNumber}}'
                  country: MEX
                  name: Virtual Account
                  accounts:
                    - externalId: 9210b519-5c29-4419-8d28-04f7543a914f
                      beneficiary:
                        type: INDIVIDUAL
                        name: Zhang
                        lastname: Wei
                        document:
                          id: EXTF900101NI1
                          type: RFC
                    - externalId: e4914217-41bc-49a5-b2f8-df950bf9bae7
                      beneficiary:
                        type: INDIVIDUAL
                        name: John
                        lastname: Doe
                        document:
                          id: EXTF900101NI2
                          type: RFC
              300 - Invalid params.:
                value:
                  externalId: de14bcf2-45ee-22e3-ab59-99c3fcba31e8
                  accountNumber: '{{accountNumber}}'
                  country: MEX
                  name: Virtual Account
                  accounts:
                    - externalId: 9210b519-5c29-4419-8d28-04f7543a914f
                    - externalId: e4914217-41bc-49a5-b2f8-df950bf9bae7
                      beneficiary:
                        type: INDIVIDUAL
                        name: John
                        lastname: Doe
                        document:
                          id: EXTF900101NI2
                          type: RFC
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  externalId:
                    type: string
                    description: >-
                      El identificador único para este proceso por lotes. Este
                      es el mismo externalId que proporcionó en la solicitud, lo
                      que confirma la operación por lotes que está consultando.
                  internalId:
                    type: string
                    description: Identificador de transacción de Localpayment.
                  accountNumber:
                    type: string
                    description: Número de cuenta de Localpayment.
                  status:
                    $ref: '#/components/schemas/status'
                  comment:
                    type: string
                    description: Información adicional.
                  errors:
                    type: array
                    description: Información adicional del error.
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          description: Código de error.
                        detail:
                          type: string
                          description: Detalles del error.
                x-examples:
                  Example 1:
                    externalId: 7facbbbf-d279-4ab5-9aeb-7583fa3f35ec
                    internalId: 1748f8f8-dcac-45d7-b1fc-7d6569245d84
                    accountNumber: '{{YourAccountNumber}}'
                    status:
                      code: '100'
                      description: INPROGRESS
                      detail: Batch Process Virtual Account in progress
                    comment: >-
                      For obtaining the asynchronous response, kindly submit a
                      request to the service after a brief interval. GET
                      {api_environment_url}/api/virtual-account-batch/7facbbbf-d279-4ab5-9aeb-7583fa3f35ec
              examples:
                100 - Batch Process Virtual Account in progress.:
                  value:
                    externalId: 7facbc4f-4c79-4a15-caeb-75833a3f35ec
                    internalId: 1748f8f8-dcac-4547-b3fb-7d6529245d84
                    accountNumber: '{{yourLocalpaymentAccountNumber}}'
                    status:
                      code: '100'
                      description: INPROGRESS
                      detail: Batch Process Virtual Account in progress
                    comment: >-
                      For obtaining the asynchronous response, kindly submit a
                      request to the service after a brief interval. GET
                      {api_environment_url}/api/virtual-account-batch/7facbbbf-d279-4ab5-9aeb-7583fa3f35ec
                300 - Invalid params.:
                  value:
                    externalId: 2f3cb0ac-1c4b-471d-a43f-1af10867d716
                    status:
                      code: '300'
                      description: REJECTED
                      detail: Invalid param + [document.id] + verification failed
                    errors:
                      - code: '300'
                        detail: Invalid param + [document.id] + verification failed
                501 - Country not found.:
                  value:
                    externalId: 75743a87-6d5e-42c4-a2ff-c596a6a27182
                    status:
                      code: '501'
                      description: REJECTED
                      detail: Country not found
                    errors:
                      - code: '501'
                        detail: Country not found
        '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-03T14:52:43.271+00:00'
                    status: 400
                    error: Bad Request.
                    message: Count can not be blank
                    path: /virtual-account/batch
              examples:
                400 - Count can not be blank.:
                  value:
                    timestamp: '2025-01-03T14:52:43.271+00:00'
                    status: 400
                    error: Bad Request.
                    message: Count can not be blank
                    path: /virtual-account/batch
                400 - External ID already used - Duplication.:
                  value:
                    timestamp: '2025-01-03T22:03:39.657+00:00'
                    status: 400
                    error: Bad Request.
                    message: External ID already used - Duplication
                    path: /virtual-account/batch
        '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
        '500':
          description: Error Interno del Servidor
          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-03T22:02:09.745+00:00'
                    status: 500
                    error: Internal Server Error
                    message: >-
                      query did not return a unique result: 12; nested exception
                      is javax.persistence.NonUniqueResultException: query did
                      not return a unique result: 12
                    path: /virtual-account/batch
              examples:
                500 - Query did not return a unique result.:
                  value:
                    timestamp: '2025-01-03T22:02:09.745+00:00'
                    status: 500
                    error: Internal Server Error
                    message: >-
                      query did not return a unique result: 12; nested exception
                      is javax.persistence.NonUniqueResultException: query did
                      not return a unique result: 12
                    path: /virtual-account/batch
      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.