Saltar al contenido principal
POST
Inicia un Wire Out para transferir fondos desde tu cuenta de Localpayment a tu propia cuenta bancaria externa.
📌 Wire Out vs. Payout
  • Un Wire Out es una liquidación / retiro: los fondos se mueven desde tu cuenta de Localpayment a tu propia cuenta bancaria externa. El beneficiario definido en el objeto to debe ser tú, el mismo titular de la cuenta de origen, nunca un tercero.
  • Un Payout es un desembolso a un destinatario final (normalmente tu cliente). Si necesitas enviar fondos a un tercero, utiliza en su lugar el endpoint Crear Payout.
Para iniciar un Wire Out, proporciona lo siguiente:
  • Datos bancarios de destino (tu propia cuenta bancaria externa): name del banco, swift, address del banco, accountName, accountNumber y beneficiaryAddress. El titular de la cuenta debe coincidir contigo como propietario de la cuenta de origen.
  • Cuenta de Localpayment de origen: el accountNumber de la cuenta de Localpayment desde la cual se debitarán los fondos.
  • Detalles de la transferencia: amount, currency, country, transactionType establecido en "WireOut", tu externalId y un comment opcional.
Si la operación es exitosa, Localpayment devuelve un internalId que puedes utilizar para dar seguimiento a la transferencia bancaria. Puedes monitorear su estado desde RECEIVED hasta Completed (fondos acreditados en tu cuenta bancaria de destino) o Rejected.

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
to
object
requerido

Cuenta bancaria de destino para el Wire Out. El beneficiario debe ser tú, el mismo titular de la cuenta de origen. Wire Out es una liquidación a tu propia cuenta bancaria externa, no un payout a un tercero. Utiliza Crear Payout si el destinatario es tu cliente.

amount
number
requerido

Importe de la transacción.

country
string
requerido

País del documento. ISO 3166-1 alfa-3. Para Wire Outs de stablecoins (USDC / USDT), utiliza GLO o el código de país ISO alfa-3 que corresponde a la billetera de destino.

currency
string
requerido

Códigos de moneda. Se admiten las stablecoins USDC y USDT.

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.

accountNumber
string
requerido

Número de cuenta de Localpayment.

transactionType
string
requerido

Tipo de transacción que se está procesando.

comment
string

Un comentario o nota asociada a la transacción.

Respuesta

OK

transactionType
string

El tipo de transacción que se está procesando.

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.

country
enum<string>

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

Opciones disponibles:
ARG,
BOL,
BRA,
CHL,
COL,
CRI,
DOM,
ECU,
SLV,
GTM,
HND,
MEX,
PAN,
PRY,
PER,
URY,
GLO
currency
enum<string>
Opciones disponibles:
ARS,
BOB,
BRL,
CLP,
COP,
CRC,
DOP,
USD,
GTQ,
MXN,
PYG,
PEN,
UYU,
USDC,
USDT
clientCode
string

Un identificador único asignado al cliente dentro del sistema Localpayment.

creationDate
string

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

errors
object[]

Un conjunto de objetos de error, en caso de que se haya producido algún error durante la transacción.

status
status · object

Estado de la operación.

accountNumber
string

Número de cuenta de Localpayment.

amount
number

Importe de la transacción.

fees
object

Detalles sobre las tarifas que se apliquen.

localTaxes
object[]

Información sobre impuestos locales.

withHoldings
object[]

Información sobre retenciones.

comment
string

Un comentario o nota asociada a la transacción.

Última modificación el 10 de noviembre de 2026