Saltar al contenido principal
POST
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.

Autorizaciones

Authorization
string
header
requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Encabezados

Authorization
string
requerido

Token de acceso Bearer para la autenticación. Se obtiene del endpoint Get Access Token.

Cuerpo

application/json
externalId
string
requerido

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
object
requerido
country
enum<string>
requerido

El país donde se encuentra la cuenta virtual (ISO 3166-1 alfa-3).

Opciones disponibles:
ARG,
BRA,
COL,
MEX,
PER,
CHL
currency
enum<string>
requerido

La moneda del pago (ISO 4217).

Opciones disponibles:
ARS,
BRL,
COP,
MXN,
PEN,
CLP
amount
number
requerido

La cantidad a simular para el pago.

accountNumber
string
requerido

El número de cuenta que Localpayment asocia con el comercio, único para cada uno.

beneficiary
object
requerido

Información sobre la entidad que recibe los fondos.

payer
object
requerido

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.

Respuesta

Creado - Simulación iniciada con éxito.

transactionType
string

El tipo de transacción (por ejemplo, PayIn).

Ejemplo:

"PayIn"

externalId
string

El identificador único (externalId) proporcionado por el comerciante para realizar el seguimiento de la transacción.

internalId
string<uuid>

El identificador único (internalId) asignado por Localpayment a la transacción.

paymentMethod
object

El método de pago utilizado para la transacción simulada.

country
string

El país donde se realizó la transacción.

currency
string

La moneda de la transacción.

amount
number

El importe de la transacción.

accountNumber
string

El número de cuenta del comerciante.

status
object

El estado de la transacción simulada.

Última modificación el 10 de noviembre de 2026