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çãoGET 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çãoGET 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
- Faça login no seu Business Portal Localpayment.
- Acesse a seção PayIn > Virtual Accounts > Activity
- 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.

