Pular para o conteúdo principal
POST
Inicie um Wire Out para transferir fundos da sua conta Localpayment para a sua conta bancária externa.
📌 Wire Out vs. Payout
  • Um Wire Out é uma liquidação / saque: os fundos saem da sua conta Localpayment para a sua própria conta bancária externa. O beneficiário definido no objeto to deve ser você, o mesmo titular da conta de origem, nunca um terceiro.
  • Um Payout é um desembolso para um destinatário final (normalmente o seu cliente). Se você precisa enviar fundos a um terceiro, use o endpoint Criar Payout.
Para iniciar um Wire Out, informe:
  • Dados bancários de destino (sua própria conta bancária externa): name do banco, swift, address do banco, accountName, accountNumber e beneficiaryAddress. O titular da conta deve corresponder a você como proprietário da conta de origem.
  • Conta Localpayment de origem: o accountNumber da conta Localpayment da qual os fundos serão debitados.
  • Dados da transferência: amount, currency, country, transactionType definido como "WireOut", o seu externalId e um comment opcional.
Em caso de sucesso, a Localpayment retorna um internalId que você pode usar para acompanhar a transferência bancária. Você pode monitorar o status dela desde RECEIVED até Completed (fundos creditados na sua conta bancária de destino) ou Rejected.

Autorizações

Authorization
string
header
obrigatório

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

Cabeçalhos

Authorization
string
obrigatório

Token de acesso Bearer para autenticação. Este token é obtido nos endpoints Obter token de acesso ou Renovar token de acesso.

Corpo

application/json
to
object
obrigatório

Conta bancária de destino do Wire Out. O beneficiário deve ser você, o mesmo titular da conta de origem. O Wire Out é uma liquidação para a sua própria conta bancária externa, não um payout para terceiros. Use Create Payout se o destinatário for seu cliente.

amount
number
obrigatório

Valor da transação.

country
string
obrigatório

País do documento. ISO 3166-1 alfa-3. Para transferências de stablecoins (USDC / USDT), use GLO ou o código de país ISO alfa-3 que corresponde à carteira de destino.

currency
string
obrigatório

Códigos de moeda. As stablecoins USDC e USDT são suportadas.

externalId
string
obrigatório

Um identificador único gerado pelo seu sistema para rastrear a transação (alfanumérico e com hífens). Recomendamos o uso do UUID4 para garantir a unicidade.

accountNumber
string
obrigatório

Número da conta Localpayment.

transactionType
string
obrigatório

Tipo de transação que está sendo processada.

comment
string

Um comentário ou nota relacionada à transação.

Resposta

OK

transactionType
string

O tipo de transação que está sendo processada.

externalId
string

Um identificador único gerado pelo seu sistema para rastrear a transação (alfanumérico e com hífens). Recomendamos o uso do UUID4 para garantir a unicidade.

internalId
string

Identificador de transação da Localpayment.

country
enum<string>

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

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

Um identificador único atribuído ao cliente dentro do sistema Localpayment.

creationDate
string

A data e a hora em que a transação foi criada, no formato ISO 8601.

errors
object[]

Uma matriz de objetos de erro, caso tenha ocorrido algum erro durante a transação.

status
status · object

Status da operação.

accountNumber
string

Número da conta Localpayment.

amount
number

Valor da transação.

fees
object

Detalhes sobre quaisquer taxas cobradas.

localTaxes
object[]

Informações sobre impostos locais.

withHoldings
object[]

Informações sobre retenções na fonte.

comment
string

Um comentário ou nota relacionada à transação.

Última modificação em 10 de novembro de 2026