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

# Simular un pago de cuenta virtual

Este endpoint permite simular un pago entrante a una cuenta virtual. **Disponible únicamente en el entorno de prueba.** Está diseñado para que los comercios prueben el flujo completo de su integración, incluyendo la recepción de notificaciones de pago y la verificación del estado de las transacciones, sin necesidad de realizar transferencias bancarias reales.

> **Restricción ambiental**
>
> Este endpoint solo está disponible en el **entorno de prueba** y está destinado exclusivamente a fines de prueba.

### Identidad del pagador

Utiliza los mismos datos del beneficiario (nombre, tipo de documento e ID del documento) que se proporcionaron al crear la cuenta virtual. No se requieren identidades de prueba adicionales; el sistema valida los datos del pagador con la información registrada durante la creación de la cuenta.


## OpenAPI

````yaml openapi/es/localpayment.json POST /api/simulate/va
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/simulate/va:
    post:
      summary: Simular un pago de cuenta virtual
      operationId: simulate-payin-to-virtual-account
      parameters:
        - name: Authorization
          in: header
          description: >-
            Token de acceso Bearer para la autenticación. Se obtiene del
            endpoint [Get Access Token](/es/reference/get-token).
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                externalId:
                  type: string
                  description: >-
                    Un identificador único para la transacción de payin
                    simulada. Este valor actúa como ID del payin generado por
                    esta simulación y debe ser diferente para cada solicitud.
                    Recomendamos usar el formato UUID4.
                paymentMethod:
                  type: object
                  properties:
                    type:
                      type: string
                      enum:
                        - BankTransfer
                      description: El tipo de método de pago que se simula.
                    code:
                      type: string
                      description: >-
                        Código del método de pago específico del país (p. ej.,
                        `1025` para ARG, `1350` para BRA, `2006` para COL,
                        `1630` SPEI o `1680` TEF para MEX, `6100` para PER,
                        `2530` para CHL).
                    flow:
                      type: string
                      enum:
                        - DIRECT
                      description: El flujo de transacciones.
                  required:
                    - type
                    - code
                    - flow
                country:
                  type: string
                  enum:
                    - ARG
                    - BRA
                    - COL
                    - MEX
                    - PER
                    - CHL
                  description: >-
                    El país donde se encuentra la cuenta virtual (ISO 3166-1
                    alfa-3).
                currency:
                  type: string
                  enum:
                    - ARS
                    - BRL
                    - COP
                    - MXN
                    - PEN
                    - CLP
                  description: La moneda del pago (ISO 4217).
                amount:
                  type: number
                  description: La cantidad a simular para el pago.
                accountNumber:
                  type: string
                  description: >-
                    El número de cuenta que Localpayment asocia con el comercio,
                    único para cada uno.
                beneficiary:
                  type: object
                  description: Información sobre la entidad que recibe los fondos.
                  properties:
                    type:
                      type: string
                      enum:
                        - INDIVIDUAL
                        - COMPANY
                      description: Tipo de beneficiario (INDIVIDUAL o COMPANY).
                    name:
                      type: string
                      description: Nombre(s) del beneficiario.
                    lastName:
                      type: string
                      description: Apellido(s) del beneficiario.
                    fullName:
                      type: string
                      description: >-
                        Nombre completo del beneficiario (concatenación de name
                        y lastName).
                    document:
                      type: object
                      description: Documento de identificación oficial del beneficiario.
                      properties:
                        type:
                          type: string
                          description: Tipo de documento (por ejemplo, CUIT, CPF, RFC).
                        id:
                          type: string
                          description: Número de documento.
                      required:
                        - type
                        - id
                    bank:
                      type: object
                      description: Detalles de la cuenta bancaria del beneficiario.
                      properties:
                        account:
                          type: object
                          description: Detalles de la cuenta.
                          properties:
                            number:
                              type: string
                              description: >-
                                El número de cuenta virtual obtenido del campo
                                `beneficiary.bank.account.number` en la
                                respuesta de [Obtener estado de la cuenta
                                virtual](/es/reference/get-virtual-account-status).
                                Este valor vincula el pago simulado con la
                                cuenta virtual correcta.
                          required:
                            - number
                      required:
                        - account
                  required:
                    - type
                    - name
                    - lastName
                    - fullName
                    - document
                    - bank
                payer:
                  type: object
                  description: >-
                    Información sobre el pagador simulado. Utiliza los mismos
                    datos (nombre, tipo de documento e ID del documento) que
                    proporcionaste para el beneficiario al crear la cuenta
                    virtual.
                  properties:
                    type:
                      type: string
                      enum:
                        - INDIVIDUAL
                        - COMPANY
                      description: Tipo de pagador (INDIVIDUAL o COMPANY).
                    name:
                      type: string
                      description: Nombre(s) del pagador.
                    lastName:
                      type: string
                      description: Apellido(s) del pagador.
                    fullName:
                      type: string
                      description: >-
                        Nombre completo del pagador (concatenación de name y
                        lastName).
                    document:
                      type: object
                      description: Documento de identificación oficial del pagador.
                      properties:
                        type:
                          type: string
                          description: Tipo de documento (por ejemplo, CUIT, CPF, RFC).
                        id:
                          type: string
                          description: Número de documento.
                      required:
                        - type
                        - id
                    email:
                      type: string
                      description: Dirección de correo electrónico del pagador.
                    bank:
                      type: object
                      description: >-
                        Detalles de la cuenta bancaria desde la cual se simula
                        el pago.
                      properties:
                        name:
                          type: string
                          description: Nombre del banco.
                        code:
                          type: string
                          description: Código del banco local.
                        account:
                          type: object
                          description: Detalles de la cuenta.
                          properties:
                            type:
                              type: string
                              description: >-
                                Tipo de cuenta (por ejemplo, CBU, CLABE,
                                AccountNumber).
                            number:
                              type: string
                              description: Número de cuenta del pagador.
                          required:
                            - number
                        branch:
                          type: object
                          description: >-
                            Detalles de la sucursal bancaria. Obligatorio para
                            Brasil.
                          properties:
                            code:
                              type: string
                              description: >-
                                El formato del código de sucursal depende del
                                banco .
                          required:
                            - code
                      required:
                        - name
                        - code
                        - account
                  required:
                    - type
                    - name
                    - lastName
                    - fullName
                    - document
                    - email
                    - bank
              required:
                - externalId
                - paymentMethod
                - country
                - currency
                - amount
                - accountNumber
                - beneficiary
                - payer
            examples:
              ARG Example:
                value:
                  externalId: de14bcf2-15ee-22e3-ab59-99c3fcba31e8
                  paymentMethod:
                    type: BankTransfer
                    code: '1025'
                    flow: DIRECT
                  country: ARG
                  currency: ARS
                  amount: 11000
                  accountNumber: '{{accountNumber}}'
                  beneficiary:
                    type: INDIVIDUAL
                    name: Carlos
                    lastName: Mendez
                    fullName: Carlos Mendez
                    document:
                      type: CUIT
                      id: '20314567894'
                    bank:
                      account:
                        number: '{{beneficiary.bank.account.number}}'
                  payer:
                    type: INDIVIDUAL
                    name: Carlos
                    lastName: Mendez
                    fullName: Carlos Mendez
                    document:
                      type: CUIT
                      id: '20314567894'
                    email: carlos.mendez@email.com
                    bank:
                      name: Banco Galicia
                      code: '007'
                      account:
                        type: CBU
                        number: '0070001200001234567890'
              MEX Example:
                value:
                  externalId: f059a032-9253-4607-9b8e-2948ed18d595
                  paymentMethod:
                    type: BankTransfer
                    code: '1630'
                    flow: DIRECT
                  country: MEX
                  currency: MXN
                  amount: 500
                  accountNumber: '{{accountNumber}}'
                  beneficiary:
                    type: INDIVIDUAL
                    name: Juan
                    lastName: Perez
                    fullName: Juan Perez
                    document:
                      type: RFC
                      id: PEPJ800101XXX
                    bank:
                      account:
                        number: '{{beneficiary.bank.account.number}}'
                  payer:
                    type: INDIVIDUAL
                    name: Juan
                    lastName: Perez
                    fullName: Juan Perez
                    document:
                      type: RFC
                      id: PEPJ800101XXX
                    email: juan.perez@email.com
                    bank:
                      name: BanCoppel
                      code: '137'
                      account:
                        type: C
                        number: '137424104400310004'
              MEX TEF Example:
                value:
                  externalId: b8c924d1-3f7a-4e82-bc1d-9a06fe37510c
                  paymentMethod:
                    type: BankTransfer
                    code: '1680'
                    flow: DIRECT
                  country: MEX
                  currency: MXN
                  amount: 1000.01
                  accountNumber: '{{accountNumber}}'
                  beneficiary:
                    type: COMPANY
                    name: Servicios Digitales México S.A.
                    document:
                      type: RFC
                      id: HEMJ900101ABC
                    bank:
                      account:
                        number: '000000000000000009'
                  payer:
                    type: COMPANY
                    name: Juan
                    lastName: Doe
                    fullName: Juan Doe
                    document:
                      type: RFC
                      id: HEMJ900101ABC
                    email: juan.doe@email.com
                    bank:
                      name: BANCO INBURSA
                      code: '036'
                      account:
                        type: CLABE
                        number: '00000000000000000001'
              BRA Example:
                value:
                  externalId: 0d55e796-bba6-4cf0-aead-8d9c1ed31044
                  paymentMethod:
                    type: BankTransfer
                    code: '1350'
                    flow: DIRECT
                  country: BRA
                  currency: BRL
                  amount: 100
                  accountNumber: '{{accountNumber}}'
                  beneficiary:
                    type: INDIVIDUAL
                    name: Rafael
                    lastName: Oliveira
                    fullName: Rafael Oliveira
                    document:
                      type: CPF
                      id: '12345678909'
                    bank:
                      account:
                        number: '{{beneficiary.bank.account.number}}'
                  payer:
                    type: INDIVIDUAL
                    name: Rafael
                    lastName: Oliveira
                    fullName: Rafael Oliveira
                    document:
                      type: CPF
                      id: '12345678909'
                    email: rafael.oliveira@email.com
                    bank:
                      name: Itau
                      code: '341'
                      account:
                        number: 12345-6
              PER Example:
                value:
                  externalId: e6807dd1-e910-41ea-9adc-b240a5509dd3
                  paymentMethod:
                    type: BankTransfer
                    code: '6100'
                    flow: DIRECT
                  country: PER
                  currency: PEN
                  amount: 200
                  accountNumber: '{{accountNumber}}'
                  beneficiary:
                    type: INDIVIDUAL
                    name: Lucia
                    lastName: Torres
                    fullName: Lucia Torres
                    document:
                      type: DNI
                      id: '45678901'
                    bank:
                      account:
                        number: '{{beneficiary.bank.account.number}}'
                  payer:
                    type: INDIVIDUAL
                    name: Lucia
                    lastName: Torres
                    fullName: Lucia Torres
                    document:
                      type: DNI
                      id: '45678901'
                    email: lucia.torres@email.com
                    bank:
                      name: BCP
                      code: '002'
                      account:
                        number: '19400123456789'
              CHL Example:
                value:
                  externalId: d2ffc771-2678-4dcc-8819-d446656a19f9
                  paymentMethod:
                    type: BankTransfer
                    code: '2530'
                    flow: DIRECT
                  country: CHL
                  currency: CLP
                  amount: 50000
                  accountNumber: '{{accountNumber}}'
                  beneficiary:
                    type: INDIVIDUAL
                    name: Valentina
                    lastName: Rojas
                    fullName: Valentina Rojas
                    document:
                      type: RUT
                      id: '123456789'
                    bank:
                      account:
                        number: '{{beneficiary.bank.account.number}}'
                  payer:
                    type: INDIVIDUAL
                    name: Valentina
                    lastName: Rojas
                    fullName: Valentina Rojas
                    document:
                      type: RUT
                      id: '123456789'
                    email: valentina.rojas@email.com
                    bank:
                      name: Banco de Chile
                      code: '001'
                      account:
                        number: '00112345678'
              COL Example:
                value:
                  externalId: b3e14f73-8452-49b2-bf3c-b770774edfa8
                  paymentMethod:
                    type: BankTransfer
                    code: '2006'
                    flow: DIRECT
                  country: COL
                  currency: COP
                  amount: 100000
                  accountNumber: '{{accountNumber}}'
                  beneficiary:
                    type: INDIVIDUAL
                    name: Andres
                    lastName: Herrera
                    fullName: Andres Herrera
                    document:
                      type: CC
                      id: '1020456789'
                    bank:
                      account:
                        number: '{{beneficiary.bank.account.number}}'
                  payer:
                    type: INDIVIDUAL
                    name: Andres
                    lastName: Herrera
                    fullName: Andres Herrera
                    document:
                      type: CC
                      id: '1020456789'
                    email: andres.herrera@email.com
                    bank:
                      name: Bancolombia
                      code: '007'
                      account:
                        number: '20012345678'
              CRI Example:
                value:
                  externalId: a1c2e3f4-5b6d-47a8-9c0e-1f2a3b4c5d6e
                  paymentMethod:
                    type: BankTransfer
                    code: '1420'
                    flow: DIRECT
                  country: CRI
                  currency: CRC
                  amount: 100
                  accountNumber: '{{accountNumber}}'
                  beneficiary:
                    type: INDIVIDUAL
                    name: Carlos
                    lastName: Mendez
                    fullName: Carlos Mendez
                    document:
                      type: CI
                      id: 2-0456-0789
                    bank:
                      account:
                        number: CR91090100000000125311
                  payer:
                    type: INDIVIDUAL
                    name: John
                    lastName: Doe
                    fullName: John Doe
                    document:
                      type: CI
                      id: 01-0100-0001
                    email: john.doe@email.com
                    bank:
                      name: Banco Nacional de Costa Rica
                      code: '0151'
                      account:
                        number: CR99000000000000000003
              CRI USD Example:
                value:
                  externalId: b2d3f4a5-6c7e-48b9-a1d0-2f3b4c5d6e7f
                  paymentMethod:
                    type: BankTransfer
                    code: '1421'
                    flow: DIRECT
                  country: CRI
                  currency: USD
                  amount: 100
                  accountNumber: '{{accountNumber}}'
                  beneficiary:
                    type: INDIVIDUAL
                    name: Carlos
                    lastName: Mendez
                    fullName: Carlos Mendez
                    document:
                      type: CI
                      id: 2-0456-0789
                    bank:
                      account:
                        number: CR91090100000000125511
                  payer:
                    type: INDIVIDUAL
                    name: John
                    lastName: Doe
                    fullName: John Doe
                    document:
                      type: CI
                      id: 01-0100-0001
                    email: john.doe@email.com
                    bank:
                      name: Banco Nacional de Costa Rica
                      code: '0151'
                      account:
                        number: CR99000000000000000002
      responses:
        '201':
          description: Creado - Simulación iniciada con éxito.
          content:
            application/json:
              schema:
                type: object
                properties:
                  transactionType:
                    type: string
                    description: El tipo de transacción (por ejemplo, PayIn).
                    example: PayIn
                  externalId:
                    type: string
                    description: >-
                      El identificador único (`externalId`) proporcionado por el
                      comerciante para realizar el seguimiento de la
                      transacción.
                  internalId:
                    type: string
                    format: uuid
                    description: >-
                      El identificador único (`internalId`) asignado por
                      Localpayment a la transacción.
                  paymentMethod:
                    type: object
                    description: El método de pago utilizado para la transacción simulada.
                    properties:
                      type:
                        type: string
                        description: El tipo de método de pago.
                      code:
                        type: string
                        description: El código específico del país para el método de pago.
                      flow:
                        type: string
                        description: El flujo de transacciones.
                  country:
                    type: string
                    description: El país donde se realizó la transacción.
                  currency:
                    type: string
                    description: La moneda de la transacción.
                  amount:
                    type: number
                    description: El importe de la transacción.
                  accountNumber:
                    type: string
                    description: El número de cuenta del comerciante.
                  status:
                    type: object
                    description: El estado de la transacción simulada.
                    properties:
                      code:
                        type: string
                        description: El código de estado.
                      description:
                        type: string
                        description: Una breve descripción del estado.
                      detail:
                        type: string
                        description: Información detallada sobre el estado.
              examples:
                MEX Example:
                  value:
                    transactionType: PayIn
                    externalId: f059a032-9253-4607-9b8e-2948ed18d595
                    internalId: 5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                    paymentMethod:
                      type: BankTransfer
                      code: '1630'
                      flow: DIRECT
                    country: MEX
                    currency: MXN
                    amount: 100
                    accountNumber: '{{accountNumber}}'
                    status:
                      code: '200'
                      description: COMPLETED
                      detail: The payin was credited
                ARG Example:
                  value:
                    transactionType: PayIn
                    externalId: de14bcf2-15ee-22e3-ab59-99c3fcba31e8
                    internalId: 5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                    paymentMethod:
                      type: BankTransfer
                      code: '1025'
                      flow: DIRECT
                    country: ARG
                    currency: ARS
                    amount: 100
                    accountNumber: '{{accountNumber}}'
                    status:
                      code: '200'
                      description: COMPLETED
                      detail: The payin was credited
                BRA Example:
                  value:
                    transactionType: PayIn
                    externalId: 0d55e796-bba6-4cf0-aead-8d9c1ed31044
                    internalId: 5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                    paymentMethod:
                      type: BankTransfer
                      code: '1350'
                      flow: DIRECT
                    country: BRA
                    currency: BRL
                    amount: 100
                    accountNumber: '{{accountNumber}}'
                    status:
                      code: '200'
                      description: COMPLETED
                      detail: The payin was credited
                PER Example:
                  value:
                    transactionType: PayIn
                    externalId: e6807dd1-e910-41ea-9adc-b240a5509dd3
                    internalId: 5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                    paymentMethod:
                      type: BankTransfer
                      code: '6100'
                      flow: DIRECT
                    country: PER
                    currency: PEN
                    amount: 100
                    accountNumber: '{{accountNumber}}'
                    status:
                      code: '200'
                      description: COMPLETED
                      detail: The payin was credited
                CHL Example:
                  value:
                    transactionType: PayIn
                    externalId: d2ffc771-2678-4dcc-8819-d446656a19f9
                    internalId: 5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                    paymentMethod:
                      type: BankTransfer
                      code: '2530'
                      flow: DIRECT
                    country: CHL
                    currency: CLP
                    amount: 50000
                    accountNumber: '{{accountNumber}}'
                    status:
                      code: '200'
                      description: COMPLETED
                      detail: The payin was credited
                COL Example:
                  value:
                    transactionType: PayIn
                    externalId: b3e14f73-8452-49b2-bf3c-b770774edfa8
                    internalId: 5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                    paymentMethod:
                      type: BankTransfer
                      code: '2006'
                      flow: DIRECT
                    country: COL
                    currency: COP
                    amount: 100000
                    accountNumber: '{{accountNumber}}'
                    status:
                      code: '200'
                      description: COMPLETED
                      detail: The payin was credited
                CRI Example:
                  value:
                    transactionType: PayIn
                    externalId: a1c2e3f4-5b6d-47a8-9c0e-1f2a3b4c5d6e
                    internalId: c06bbea8-48d1-4659-9664-633b7f9f080d
                    paymentMethod:
                      type: BankTransfer
                      code: '1420'
                      flow: DIRECT
                    country: CRI
                    currency: CRC
                    amount: 100
                    accountNumber: '{{accountNumber}}'
                    status:
                      code: '200'
                      description: COMPLETED
                      detail: The payin was credited
                CRI USD Example:
                  value:
                    transactionType: PayIn
                    externalId: b2d3f4a5-6c7e-48b9-a1d0-2f3b4c5d6e7f
                    internalId: e05fc3c3-f739-4393-b275-4a12f5a1af16
                    paymentMethod:
                      type: BankTransfer
                      code: '1421'
                      flow: DIRECT
                    country: CRI
                    currency: USD
                    amount: 100
                    accountNumber: '{{accountNumber}}'
                    status:
                      code: '200'
                      description: COMPLETED
                      detail: The payin was credited
        '400':
          description: 'Solicitud incorrecta: parámetros o número de cuenta no válidos.'
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    description: Código de estado HTTP.
                  error:
                    type: string
                    description: Nombre breve del error.
                  message:
                    type: string
                    description: Mensaje de error legible.
                  path:
                    type: string
                    description: Ruta de la API donde ocurrió el error.
              examples:
                Bad Request:
                  value:
                    status: 400
                    error: Bad Request
                    message: Invalid payer identity or missing mandatory fields.
                    path: /api/simulate/va
        '401':
          description: 'No autorizado: token no válido o caducado.'
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    description: >-
                      Un mensaje de error detallado que explica por qué el token
                      no es válido.
                  code:
                    type: string
                    description: Un código de error legible por máquina.
                  messages:
                    type: array
                    description: >-
                      Una lista de mensajes que proporcionan más contexto sobre
                      el fallo de autenticación.
                    items:
                      type: object
                      properties:
                        token_class:
                          type: string
                          description: Clase del token (p. ej., AccessToken).
                        token_type:
                          type: string
                          description: Tipo de token (por ejemplo, access).
                        message:
                          type: string
                          description: Mensaje de error específico del token.
              examples:
                Unauthorized:
                  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
        '404':
          description: No encontrado - Cuenta virtual no encontrada.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    description: Código de estado HTTP.
                  error:
                    type: string
                    description: Nombre breve del error.
                  message:
                    type: string
                    description: Mensaje de error legible.
                  path:
                    type: string
                    description: Ruta de la API donde ocurrió el error.
              examples:
                Not Found:
                  value:
                    status: 404
                    error: Not Found
                    message: >-
                      Virtual Account with externalId
                      de14bcf2-15ee-22e3-ab59-99c3fcba31e8 not found.
                    path: /api/simulate/va
        '500':
          description: Error Interno del Servidor.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    description: Código de estado HTTP.
                  error:
                    type: string
                    description: Nombre breve del error.
                  message:
                    type: string
                    description: Mensaje de error legible.
                  path:
                    type: string
                    description: Ruta de la API donde ocurrió el error.
              examples:
                Server Error:
                  value:
                    status: 500
                    error: Internal Server Error
                    message: An unexpected error occurred while simulating the payment.
                    path: /api/simulate/va
      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.