Skip to main content
A busca global ajuda você a encontrar rapidamente objetos importantes da organização sem precisar navegar menu por menu. Ela fica centralizada no header do Dashboard e funciona a partir do contexto da organização atual. Você pode estar em Produtos, Faturas ou Analytics e ainda assim buscar um cliente, uma transação, uma assinatura, uma fatura, um request, um webhook, um payment link ou um preço. Use quando você já tem alguma pista do que procura: um e-mail de cliente, parte de um nome, um CPF/CNPJ, um número de fatura, uma URL de webhook ou um ID como cus_*, prod_*, price_*, inv_*, txn_* ou req_*.
A busca respeita o ambiente selecionado no Dashboard. Em Sandbox, os resultados vêm de dados de teste; em produção, vêm de dados live.

Por que usar

A busca global reduz o tempo entre saber o que você procura e abrir o objeto certo. Ela é útil para:
  • Encontrar um cliente pelo e-mail durante um atendimento.
  • Abrir rapidamente uma fatura, transação ou assinatura a partir de um ID.
  • Localizar um produto ou preço sem passar pela listagem.
  • Investigar requests e webhooks ao depurar uma integração.
  • Navegar pelo Dashboard sem depender da página aberta agora.

Como abrir

No Console de Organização, clique no campo Pesquisar no header. Você também pode abrir a busca pelo teclado com ⌘K no macOS, Ctrl K no Windows/Linux ou / quando nenhum campo de formulário estiver em foco. Digite pelo menos dois caracteres. A busca começa automaticamente enquanto você digita; não é necessário pressionar Enter. Os resultados aparecem em uma lista com o tipo do objeto, informação principal, status ou valor quando disponível.

O que você pode encontrar

Quero encontrarPosso buscar porPara onde vou
ClienteID, e-mail, nome ou CPF/CNPJPágina de Clientes
ProdutoID ou nomeDetalhe do produto
PreçoID ou nomeProduto relacionado
AssinaturaID, cliente, fatura mais recente ou checkout de origemDetalhe da assinatura
FaturaID, número, cliente, payment intent ou transaçãoDetalhe da fatura
TransaçãoID, identificador externo, número da fatura ou descriçãoDetalhe da transação
RequestID, método, path ou status codeLog do request
WebhookID ou URL do endpointEndpoint de webhook
Payment LinkID, label ou secret do linkLink de pagamento

Como os resultados aparecem

Quando você cola um ID completo, o objeto correspondente aparece no topo. Em buscas por texto, a Chargefy prioriza sinais mais diretos, como e-mail de cliente, número de fatura, nome de cliente, nome de produto e nome de preço. Quando vários resultados são parecidos, os mais recentes aparecem antes. Isso ajuda em operações comuns, como procurar o cliente que acabou de pagar ou abrir uma cobrança recém-criada.

Escopo e permissões

A busca só retorna objetos da organização atual e só mostra dados que o seu papel tem permissão para ler. Se uma função da equipe não tem acesso a dados de negócio, esses objetos não aparecem nos resultados. Hoje a busca global está disponível no Console de Organização. O Console de Plataforma continua usando suas páginas próprias para navegar entre organizações conectadas.

Boas práticas

  • Cole o ID completo quando tiver (inv_*, txn_*, req_*) para abrir o objeto mais rápido.
  • Use e-mail, nome ou CPF/CNPJ quando estiver procurando um cliente.
  • Use o nome do produto ou do preço quando estiver navegando pelo catálogo.
  • Use número da fatura ou ID de payment intent quando estiver conciliando uma cobrança.
  • Use path ou status code quando estiver investigando requests de API.