Pular para o conteúdo principal
O painel em dashboard.caratuva.com é sua cabine de operação. Ele é organizado em torno do trabalho do dia a dia para receber: onboarding, faturamento, aprovações, repasses e reconciliação. A barra lateral tem: Invoices (Faturas), Payout (Repasses), Notifications (Notificações), Developers (Desenvolvedores), Enable production (Habilitar produção) e — para usuários de operações — Admin.

Login

Entre com seu e-mail corporativo — enviamos um magic link (expira em 15 minutos), sem senha para gerenciar. As sessões duram 12 horas. Faça logout pelo botão no cabeçalho do painel. O primeiro usuário de uma organização é um admin. O modelo de papéis é: admin (acesso total — chaves de API, repasses, faturas), treasurer (cria e aprova faturas, gerencia o destino de repasse), viewer (somente leitura) e ops (ferramentas operacionais, incluindo a tela Admin). Convidar colegas e atribuir papéis ainda não é self-service no painel — entre em contato com o suporte se precisar de mais usuários na sua organização.

Seletor de modo

Toda tela traz um indicador de modo no topo. O modo Teste roda o fluxo inteiro contra uma instância de pagamento sandbox — KYB e KYC do comprador são aprovados automaticamente e nenhum dinheiro real se move. O modo Produção (live) opera sobre trilhos reais; ele é destravado assim que a Caratuva aprova sua Solicitação de Acesso à Produção (veja Habilitar produção), após o que você completa o KYB de produção. Trocar de modo é um único clique. Contas novas começam em teste. Recomendamos fortemente rodar o primeiro fluxo de ponta a ponta no modo teste antes de ir para produção. Veja Modos teste e produção para o que cada modo cobre.

Faturas

A área de faturas é onde a maior parte do trabalho acontece.

Lista

/invoices mostra todas as faturas da sua organização. Clique em qualquer linha para abrir o detalhe da fatura, ou use a ação Duplicate (Duplicar) por linha para iniciar um pedido recorrente.

Detalhe

A página de detalhe mostra o cabeçalho da fatura, o comprador, os itens e uma linha do tempo que atualiza ao vivo conforme o pagamento avança pelo ciclo de vida:
draft → awaiting_approval → approved
      → awaiting_buyer
      → buyer_kyc_pending → buyer_kyc_approved
      → fx_quoted
      → on_ramp_pending → fiat_received
      → offramp_pending
      → settled
settled é o estado terminal de sucesso. Os outros estados terminais — expired, cancelled e buyer_kyc_rejected — são exibidos com o motivo. on_ramp_failed e offramp_failed são falhas em andamento que podem ser repetidas. Pelo detalhe você pode, dependendo do estado da fatura:
  • Editar a fatura (enquanto estiver em draft ou awaiting_approval).
  • Aprovar a fatura (um colega diferente do criador, quando a aprovação é exigida).
  • Convidar o comprador, ou reenviar o e-mail de convite caso o original tenha sido perdido.
  • Copiar o link público de pagamento para enviar pelo seu próprio canal.
  • Reatribuir o comprador (útil quando um fluxo de KYC fica travado — o novo comprador começa com um estado limpo).
  • Cancelar a fatura (válido somente antes de o comprador fundar o on-ramp).
  • Duplicar a fatura para um pedido recorrente.

Nova fatura

/invoices/new é um formulário passo a passo para criar uma fatura. Você também pode clonar uma fatura existente com ?from=<invoiceId> para pré-preencher comprador e itens — útil para pedidos recorrentes. Veja Faturamento para o fluxo completo, incluindo aprovações e regras de cancelamento.

Repasses

/payout (barra lateral: Payout) roda toda a configuração de repasse como um único fluxo:
  1. Aceitar os termos de serviço do nosso parceiro de liquidação — um redirecionamento único para a página hospedada do parceiro e de volta.
  2. Verificar sua empresa (KYB) — seu envio, status atual e o que ainda nos falta. Veja Onboarding.
  3. Registrar sua chave PIX — uma única chave PIX na conta bancária brasileira que recebe cada liquidação (nosso parceiro de liquidação detecta automaticamente o tipo da chave). Ela precisa corresponder à entidade verificada legalmente. Veja Repasses.

Desenvolvedores

/developers reúne a superfície de integração para o time de engenharia.
  • Chaves de API (/developers/api-keys) — emita e revogue credenciais servidor-a-servidor. O segredo em texto plano aparece exatamente uma vez na criação; copie-o imediatamente para o cofre de senhas.
  • Webhooks (/developers/webhooks) — cadastre URLs que devem receber eventos do ciclo de vida, veja tentativas recentes de entrega e gire segredos de assinatura.
Ambas as telas estão documentadas em detalhe na Referência da API.

Habilitar produção (ir para produção)

/go-live (barra lateral: Enable production) é a solicitação self-service de acesso à produção. Envie sua razão social, CNPJ, e-mail de contato comercial, volume mensal esperado e corredores. Assim que a Caratuva aprovar, a opção Produção é destravada no seletor de modo; você então troca para Produção e completa o KYB de produção na página de Repasses. Veja Modos teste e produção.

Notificações

/notifications (barra lateral: Notifications) é um log de entrega somente leitura — toda mensagem que esta organização disparou, com seu canal, template, destinatário, status e referência. Filtre por canal, status e período. Útil para verificar se os convites ao comprador realmente saíram e para responder “o cliente recebeu o link?”. O sino no cabeçalho é uma caixa de entrada separada, por usuário (alimentada pela Courier), mostrando seus alertas não lidos. Não há configurações de preferência de notificação por usuário hoje.

Admin (somente operações)

Usuários com o papel ops ganham um item Admin na barra lateral (/admin/production-access) para revisar e aprovar solicitações de acesso à produção das organizações. Ele não fica visível para outros papéis.

Relatórios

Resumos de preços de transferência (JSON, CSV, PDF) estão disponíveis via API (GET /v1/reports/transfer-pricing), ainda não como uma tela do painel. Fale com nosso time se precisar de um corte específico para o seu fechamento contábil trimestral.

Para onde ir