Pular para o conteúdo principal
Este guia descreve as diferentes abordagens para rastrear o status de Virtual Accounts e gerenciar o ciclo de vida da conta. O Localpayment oferece diversos métodos para monitorar e obter o status atual de Virtual Accounts, incluindo verificações de contas individuais, status de processamento em lote e visualização no Business Portal.

Disponibilidade

O monitoramento do status de Virtual Account está disponível em todos os países onde as Virtual Accounts são suportadas:

Antes de começar

Certifique-se de ter:
  • Credenciais de API válidas (token de acesso).
  • IDs de Virtual Accounts ou números de referência de lote que você deseja verificar.

Referência de Status da Virtual Account

As Virtual Accounts podem ter os seguintes status ao longo de seu ciclo de vida:
Os códigos de status não são exclusivos dos status de Virtual Account. Por exemplo, o código 300 também aparece com a descrição REJECTED no endpoint Criar uma Virtual Account quando uma solicitação falha na validação. Sempre leia status.code junto com status.description em vez de depender apenas do código.

Recuperar informações da Virtual Account

Após solicitar sua Virtual Account, você poderá verificar o status dela usando qualquer um dos seguintes métodos:

Verifique o status da sua Virtual Account individual

Recupere o status atual e os detalhes de uma Virtual Account específica usando o endpoint da API com o ID externo.

Verificar o status da Virtual Account em lote

Monitore o status das Virtual Accounts criadas em operações em lote, incluindo o progresso da criação e quaisquer erros.

Consulte o status da sua Virtual Account pelo portal da empresa.

Utilize a interface visual do Business Portal para monitoramento manual, filtragem e operações em massa em Virtual Accounts.

Método 1: Verificar o status da Virtual Account individual

Recupere o status atual e os detalhes de uma Virtual Account específica usando o endpoint de status individual.

Exemplo de solicitação

Envie uma requisição GET para o endpoint Get Virtual Account Status. Abaixo está um exemplo usando curl:
curl

Parâmetros-chave da solicitação

A solicitação requer vários objetos-chave:

Resposta bem-sucedida

Campos de resposta principais


Método 2: Verificar o status da Virtual Account em lote

Monitore o status das Virtual Accounts criadas em operações em lote, incluindo o progresso da criação e quaisquer erros.

Exemplo de solicitação

Envie uma requisição GET para o endpoint Get Virtual Account Status (Batch). Abaixo está um exemplo usando curl:
curl

Parâmetros-chave da solicitação

A solicitação requer vários objetos-chave:

Resposta bem-sucedida

Campos de resposta principais


Método 3: Verificar o status da Virtual Account pelo portal da empresa

Para monitoramento manual e análise visual, utilize o Business Portal da Localpayment para visualizar o status da Virtual Account.

Acesso ao Business Portal

  1. Faça login no seu Business Portal Localpayment.
  2. Acesse a seção PayIn > Virtual Accounts > Activity
  3. Utilize filtros para pesquisar por:
    • País: Escolha um país específico ou selecione Todos para incluir todos os países disponíveis.
    • Status: Filtre as contas pelo status atual ou selecione Todas para visualizar as contas com qualquer status.
    • Intervalo de datas: Especifique o intervalo de datas em que as Virtual Accounts foram criadas. Isso filtra a lista com base na data de criação, não na data de atividade.
    • Virtual Account Number: Você pode pesquisar diretamente pelo Virtual Account Number (VAN) para localizar rapidamente uma entrada específica.

Próximos passos

Após monitorar o status da Virtual Account, talvez seja necessário executar ações de gerenciamento adicionais:

Instruções de pagamento

Forneça aos pagadores os dados corretos do beneficiário retornados na resposta da API Get Virtual Account Status para processar pagamentos sem problemas. Consulte as instruções específicas de cada país para garantir a execução precisa e em conformidade com as normas.

Ativar/Desativar Virtual Account

Suspenda ou reative temporariamente Virtual Accounts de acordo com as necessidades da empresa ou solicitações dos clientes.

Excluir Virtual Account

Desative permanentemente uma Virtual Account. Isso impede todos os pagamentos futuros para ela, mas mantém todo o seu histórico. A ação é irreversível. Use para contas que não são mais necessárias; crie uma nova para retomar as operações.
Última modificação em 10 de novembro de 2026