Pular para o conteúdo principal
POST
Este endpoint permite criar múltiplas Virtual Accounts para receber transferências bancárias ACH locais. Ao atribuir essas contas a comerciantes ou usuários finais específicos, você pode simplificar o processo de conciliação e aprimorar o rastreamento de transações.

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
externalId
string
obrigatório

Um identificador único que você fornece para rotular e rastrear Virtual Accounts dentro do seu sistema. Este ID será a principal referência para todas as operações futuras nesta conta (por exemplo, verificar o status, desativar, excluir). Para garantir a exclusividade e evitar conflitos, recomendamos fortemente o uso do formato UUID4.

accountNumber
string
obrigatório

Número da conta Localpayment.

country
enum<string>
obrigatório

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

Opções disponíveis:
ARG,
BRA,
CHL,
COL,
MEX,
PER
beneficiary
beneficiário · object
obrigatório

A pessoa física ou jurídica que receberá os fundos depositados nesta Virtual Account. O beneficiário é o destinatário final do dinheiro e não é necessariamente o proprietário ou titular legal da própria Virtual Account.

Exemplo:

Resposta

Criado

currency
enum<string>
Opções disponíveis:
ARS,
BRL,
CLP,
COP,
USD,
MXN,
PEN
externalId
string

O identificador único da Virtual Account. Esse é o mesmo valor externalId fornecido na solicitação de criação, confirmando que ela foi registrada com sucesso em nosso sistema. Utilize este identificador exato para todas as chamadas de API subsequentes relacionadas a esta conta.

internalId
string

Identificador de transação da Localpayment.

accountNumber
string

Número da conta Localpayment.

beneficiary
object

A pessoa física ou jurídica que receberá os fundos depositados nesta Virtual Account. O beneficiário é o destinatário final do dinheiro e não é necessariamente o proprietário ou titular legal da própria Virtual Account.

status
status · object

Status da operação.

errors
object[]

Informações adicionais sobre o erro.

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