Saltar al contenido principal
POST
Inicia payouts sin complicaciones desde tu cuenta de Localpayment a cualquier beneficiario con una sola llamada a la API. Este endpoint te permite transferir fondos a clientes, proveedores o socios proporcionando detalles esenciales como la información del beneficiario, el monto de la transferencia, la cuenta de origen y el código del concepto. Recibirás una confirmación inmediata de la creación del payout o mensajes de error detallados para la resolución de problemas, lo que agiliza todo tu flujo de trabajo de payouts y garantiza transferencias precisas y puntuales.
¿Deseas fijar un tipo de cambio antes de ejecutar la transacción?Usa la API de cotización de cambio de divisas para generar una cotización del tipo de cambio para el par de divisas. La respuesta incluye un exchangeRateToken; inclúyelo en tu solicitud de payout 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.
Acerca del campo comment Este valor se transmite a través de la red de pagos a la institución receptora. Su visualización para el destinatario final depende de la institución receptora y de cómo presente los detalles de la transacción.

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.

Cuerpo

application/json
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
enum<string>
requerido

El país de su usuario final (es decir, el país en el que se procesará el pago), en formato ISO.

Opciones disponibles:
ARG,
BOL,
BRA,
CHL,
COL,
CRI,
DOM,
GTM,
HND,
MEX,
PAN,
PRY,
PER
currency
enum<string>
requerido

Especifica el código de moneda. Elige entre: (A) la moneda local del país seleccionado o (B) la moneda de tu cuenta. En el caso de (A), el cargo se realiza en la moneda local del cliente. En el caso de (B), el importe se abona en tu cuenta y Localpayment gestiona el cambio de divisas para cobrar el importe equivalente en moneda local.

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

El importe de la transacción debe especificarse como un número decimal utilizando un separador de puntos, excepto para el CLP (peso chileno), que debe proporcionarse sin decimales.

accountNumber
string
requerido

Número de cuenta de Localpayment en la que se debitará el importe.

conceptCode
enum<string>
requerido
Opciones disponibles:
0001,
0002,
0003,
0004,
0005,
0006,
0007,
0008,
0009,
0010,
0011,
0012,
0013,
0014,
0015,
0016,
0017,
0018,
0019,
0020,
0021,
0022,
0023,
0024,
0025,
0026,
0027,
0028,
0029,
0030,
0031,
0032,
0033,
0034,
0035,
0036,
0037,
0038,
0039,
0040
paymentMethod
object
requerido
sender
object
requerido

Información del remitente.

beneficiary
object
requerido

Información del beneficiario.

merchant
object
requerido

Información del comerciante.

comment
string

Campo de texto libre para información adicional sobre el pago. Se transmite a través de la red de pagos a la institución receptora; la visibilidad para el destinatario final depende del banco. Consulta los detalles por país en esta página.

requireAuth
boolean

Cuando el valor se establece en "Verdadero", el endpoint del Autorizador debe ser ejecutado por el ID interno para actualizar el estado a recibido.

Respuesta

Creado

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
country
string
currency
enum<string>
Opciones disponibles:
ARS,
BOB,
BRL,
CLP,
COP,
CRC,
DOP,
USD,
GTQ,
MXN,
PYG,
PEN,
UYU
amount
integer

Importe de la transacción.

accountNumber
string

Número de cuenta de Localpayment.

clientCode
string

Código del cliente.

clientName
string

Nombre del cliente.

status
status · object

Estado de la operación.

beneficiary
object
merchant
object

Información del comerciante.

sender
object

Información del remitente.

comment
string

Campo de texto libre para información adicional sobre el pago. Se transmite a través de la red de pagos a la institución receptora; la visibilidad para el destinatario final depende del banco. Consulta los detalles por país en esta página.

exchangeRateToken
null

Token de tipo de cambio.

date
object
errors
object[] | null

Información de error.

internalLoteID
string

Identificador interno del lote.

Última modificación el 10 de noviembre de 2026