Saltar al contenido principal
POST
Este endpoint inicia una transacción Payin, lo que te permite cobrar a tus clientes mediante diversos métodos de pago. Puedes especificar detalles como el método de pago, el importe, la moneda y la información del cliente. La respuesta incluirá un ID de transacción y su estado, que podrás utilizar para realizar el seguimiento del pago.
¿Deseas fijar un tipo de cambio antes de ejecutar la transacción?Usa la API de cotización de tipo de cambio para generar una cotización de tipo de cambio para el par de divisas. La respuesta incluye un exchangeRateToken; inclúyelo en tu solicitud de payin para fijar ese tipo de cambio. El tipo de cambio cotizado está garantizado hasta la expirationDate del token, lo que protege tanto a ti como a tu usuario de las fluctuaciones del mercado.

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. Este token se obtiene de los endpoints Get Access Token o Refresh Access Token.

x-capture
boolean

Envía true para generar una autorización.

Cuerpo

application/json
paymentMethod
object
requerido

Detalles del método de pago.

externalId
string
requerido

Un identificador único generado por tu sistema para rastrear la transacción (alfanumérico y con guiones). Recomendamos usar UUID4 para garantizar su unicidad.

country
string
requerido

País. ISO 3166-1 alfa-3.

currency
enum<string>
requerido

Códigos de moneda. La moneda del importe puede ser la moneda local (cobrada directamente) o la moneda de la cuenta (lo que activa una operación de cambio de divisas), y paymentMethod.code resuelve la ambigüedad en los países bimonetarios.

Opciones disponibles:
ARS,
BOB,
BRL,
CLP,
COP,
CRC,
DOP,
USD,
GTQ,
MXN,
PYG,
PEN
amount
number
requerido

Importe de la transacción.

Ejemplo:

2500.25

accountNumber
string
requerido

El número de cuenta de LocalPayment donde se abonará el importe especificado.

conceptCode
string
requerido
Ejemplo:

"0001"

merchant
object
requerido

Información sobre el comerciante que inicia la transacción.

payer
object
requerido

Información sobre el pagador que realiza la transacción.

commercialData
object
requerido

Contiene detalles comerciales sobre la transacción.

card
object
requerido

Requerido para los métodos de pago con tarjeta de crédito y débito.

comment
string

Información adicional para identificar la transacción por tu parte.

intermediaries
object[]

Información adicional de otras partes involucradas en el proceso de pago.

metaData
object

Contiene información adicional sobre la transacción.

transactionType
any

Tipo de transacción.

clientCode
string

Código del cliente.

userReference
string

Nombre de usuario de su cliente. Por ejemplo, correo electrónico o nombre de usuario en tu plataforma.

requireAuth
boolean

Indica si la transacción requiere autenticación.

file
boolean

Indica si la transacción implica la carga de un archivo.

exchangeRateToken
string

Token proporcionado por el servicio de cambio de divisas para utilizar un tipo de cambio acordado previamente.

device
object

Contiene información sobre el dispositivo utilizado para iniciar la transacción.

redirectUrl
object

Define las URL para los escenarios de autenticación utilizando 3DS.

Respuesta

OK

transactionType
any

Tipo de transacción.

externalId
string

Un identificador único generado por tu sistema para rastrear la transacción (alfanumérico y con guiones). Recomendamos usar UUID4 para garantizar su unicidad.

internalId
string

Identificador de transacción de Localpayment.

paymentMethod
object

Métodos de pago para payins.

country
string

País. ISO 3166-1 alfa-3.

currency
enum<string>
Opciones disponibles:
ARS,
BOB,
BRL,
CLP,
COP,
CRC,
DOP,
USD,
GTQ,
MXN,
PYG,
PEN,
UYU
amount
number

Importe de la transacción.

accountNumber
string

Número de cuenta de Localpayment.

confirmed
object

Cantidad confirmada.

payment
object

Detalles sobre el pago realizado.

localTaxes
object[]

Información sobre impuestos locales.

withHoldings
object[]

Información sobre retenciones.

fees
object

Detalles sobre las tarifas que se apliquen.

status
status · object

Estado de la operación.

merchant
object

Información del comerciante.

payer
object

Información sobre la persona que realizó el pago.

intermediaries
object[]

Información sobre cualquier intermediario involucrado en la transacción.

wireInstructions
object

Datos bancarios para la transferencia.

date
object

Fechas asociadas a la transacción.

errors
object[]

Lista de errores que se produjeron durante la transacción.

redirectUrl
string

Si es necesario, esta propiedad proporciona una URL a la que se redirigirá al usuario para completar el proceso de pago.

ticket
object | null

Información sobre un ticket asociado con la transacción (si corresponde).

qr
object | null

Información sobre el código QR asociado a la transacción (si procede).

card
string | null

Datos de la tarjeta.

code
string

Estado de la redirección.

transactionFlow
string

Flujo de la transacción.

createdOn
string

Fecha y hora en que se creó la transacción, en formato ISO 8601.

createdBy
string

La dirección de correo electrónico del usuario que realizó la transacción.

executionData
object
Última modificación el 10 de noviembre de 2026