Pular para o conteúdo principal
PUT
Ativar ou desativar uma Virtual Account
Este endpoint permite ativar ou desativar temporariamente uma Virtual Account. Use-o para suspender o recebimento de novos fundos em uma conta específica (desativar) ou para reativá-la e permitir que volte a aceitar pagamentos (ativar). Isso é útil para gerenciar contas de clientes durante análises de conformidade, pausar assinaturas ou aplicar outros controles operacionais.

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.

Parâmetros de caminho

status
enum<string>
obrigatório

enable ou disable.

Opções disponíveis:
enable,
disable
Exemplo:

"enable"

externalId
string
obrigatório

O identificador único da Virtual Account que você deseja gerenciar. Este deve ser exatamente o mesmo valor de externalId fornecido ao criar a conta. Use este identificador para especificar a conta de destino para operações como ativá-la ou desativá-la.

Pattern: [a-zA-Z0-9\- ]+
Exemplo:

"53025bf4-4c87-4b4f-8fea-b47004440f37"

Resposta

OK

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

O identificador único da Virtual Account. Este é o mesmo externalId fornecido em sua solicitação, confirmando que a operação foi realizada na conta correta.

internalId
string

Identificador de transação da Localpayment.

accountNumber
string

Número da conta Localpayment.

beneficiary
beneficiário · 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.

Exemplo:
status
status · object

Status da operação.

errors
object[]

Matriz de erros que ocorreram durante a transação. Se a transação foi bem-sucedida, esta matriz estará vazia.

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