Faturas e razão
Onde no admin: Finance › Billing (
/billing) com as abas Overview, Transactions (/billing/ledger), Invoices (/billing/invoices), Top-ups (/billing/deposits), Payouts (/billing/payouts), Vouchers (/billing/vouchers) e Reports (/billing/reports). Onde no portal: Billing (/billing).
O que faz
Cada valor no NexCMP é armazenado em centavos de USD e registrado uma vez. A ideia principal: o wallet ledger é a fonte de verdade para os saldos; faturas, pagamentos de recarga e relatórios são visualizações construídas a partir dele. O registro é somente anexação — um erro é corrigido adicionando uma entrada de estorno, nunca editando o histórico.
Requisitos
| Item | Requisito |
|---|---|
| Função | Um administrador. |
| Detalhes do vendedor | Defina o nome legal, ID fiscal, endereço, e-mail de contato e o prefixo do número da fatura em System › Settings › General, aba Seller & invoicing (/settings?tab=seller), cartão Seller details (printed on invoices). |
| Dependências | Payment channels para entrada de dinheiro. |
As peças
| Aba de admin | O que lista | Uso típico |
|---|---|---|
| Overview | Receita hoje e neste mês, totais do razão por tipo (depósito, cobrança, reembolso, ajuste, voucher), faturas por status, reembolsos pendentes, atalhos, gastos por serviço nos últimos 30 dias | Verificação diária |
| Transactions | O razão da carteira, uma linha por movimento | Explicar o saldo de um cliente |
| Invoices | Faturas e uma segunda visualização Orders com cada compra de cada serviço | Encontrar um documento, reenviar, marcar como pago |
| Top-ups | Pagamentos recebidos através dos gateways | Verificar um pagamento, reembolsá-lo |
| Payouts | Reembolsos de cartão, pagamentos de afiliados, saques de revendedores | Aprovar saída de dinheiro |
| Vouchers | Códigos de recarga | Ver Promotions |
| Reports | Receita, por serviço, por revendedor | Contabilidade |
Transactions (ledger)
Colunas: horário, cliente, tipo, serviço, valor (com sinal), VM, referência, ator, nota. Filtros: tipo, serviço, ID do cliente, site (quando você tiver revendedores), intervalo de datas e um link de VM.
| Tipo | Significado |
|---|---|
deposit | Recarga de um gateway |
charge | Dinheiro retirado por um serviço (pedido, renovação, uso por hora...) |
refund | Dinheiro devolvido à carteira |
adjust | Crédito ou débito do administrador e também códigos de recarga (referência começando com vch:) — a visão geral mostra os vouchers em sua própria linha |
Cada linha tem uma referência como dep:stripe:<payment-id>; a mesma referência nunca pode ser gravada duas vezes, por isso um webhook repetido não pode creditar duas vezes. Use Customers › List › customer › Credit / debit para adicionar um ajuste manual: um motivo é obrigatório, um valor positivo também tenta desbloquear VMs bloqueadas por falta de fundos e a ação é confirmada em duas etapas.
Invoices
Uma fatura é criada automaticamente quando um cliente compra ou renova algo pago com a carteira, ou para uma recarga. Os números parecem com <prefix><YYYYMM>-<000001> (por exemplo, NX202610-000042); sites de revendedores usam seu próprio prefixo e sequência. Números existentes nunca mudam quando você altera o prefixo.
| Campo | Valores |
|---|---|
| Tipo | Receipt, Renewal, Top-up, Manual, Refund |
| Status | Unpaid, Paid, Overdue, Cancelled, Refunded |
Ações em uma linha:
| Ação | Efeito |
|---|---|
| View / Print | Abre a fatura; o portal também pode imprimir ou salvar como PDF. |
| Mark paid (apenas não paga ou vencida) | Marca como paga sem movimentar dinheiro da carteira — use quando o cliente pagou fora do NexCMP. Um motivo é obrigatório. Para uma fatura de renovação, também estende e desbloqueia a VM bloqueada. |
| Cancel (apenas não paga ou vencida) | Cancela a fatura. Um motivo é obrigatório. |
| Resend | Envia a fatura por e-mail novamente. |
Create manual invoice (botão no topo da aba): ID do cliente, 1 a 50 linhas (descrição, quantidade, preço unitário), ID de VM opcional, dias para vencimento opcionais (0 a 365, padrão 7), nota opcional. É criado como não pago; o cliente vê em Billing › Invoice History.
Faturas não pagas de serviços são quitadas automaticamente a partir da carteira assim que houver saldo, portanto a ação do cliente é simplesmente fazer uma recarga.
Recargas (pagamentos)
Uma linha por tentativa: hora, cliente, gateway e método, tipo (recarga ou recarga automática), status (pendente, concluído, falhou, reembolsado, contestado, cancelado), o que o cliente pagou, a taxa, o que foi para a carteira, a referência do gateway e a hora de conclusão. Pagamentos concluídos do Stripe e PayPal têm uma ação de Refund. Use as páginas de eventos do Gateway para ver webhooks (Payment channels).
Pagamentos de saída
Três sub-abas: Card refunds (aprovar ou rejeitar solicitações de reembolso; a solicitação é criada a partir de um pagamento concluído), Affiliate payouts (saques de comissão) e Reseller withdrawals. Cada decisão é auditada.
Reports
Revenue (tendência de 30 dias, mês a mês, principais clientes), By service e By reseller.
O que o cliente vê
Em Billing, o cliente tem Balance, Deposit, Redeem code, Settings (recarga automática) e um histórico com as abas Invoice History, Payment Order, Ledger e Orders (cada serviço em uma lista com filtros por serviço e tipo). Cada fatura possui View, Print e Save as PDF; os valores estão em USD, exibidos opcionalmente na moeda de exibição.
Verificar
- Faça uma pequena recarga como cliente de teste.
- Transactions exibe uma linha
deposit, Top-ups mostra o pagamento como Completed e a receita em Overview aumenta. - Compre algo: uma linha
chargeaparece e Invoices exibe uma fatura do tipo Receipt ou Renewal com os detalhes do vendedor que você configurou.
Limites e notas
- Somente adição. Não é possível editar ou excluir uma linha do razão; adicione um ajuste com um motivo.
- Moeda. Os valores são em USD; a moeda de exibição é cosmética (consulte Currency and exchange rates).
- Reembolso para o cartão é feito em duas etapas (solicitação e, em seguida, aprovação em Payouts); USDT e transferências bancárias não são reembolsados para a origem.
- Tudo é auditado em System › Logs › Admin actions com o motivo que você informou.
- Pedidos vs faturas. O uso por hora não é faturado por hora; a visualização Orders o agrupa por dia para que você ainda possa vê-lo.
Resolução de problemas
| Sintoma | Causa | Correção |
|---|---|---|
| O saldo do cliente parece incorreto | Uma cobrança, ajuste ou voucher inesperado | Filtre Transactions pelo ID do cliente e leia as referências e notas. |
| "A fatura já está paga" (409) | Marcar como paga em uma fatura paga | Nada a fazer. |
| Não é possível cancelar uma fatura | Apenas faturas não pagas ou vencidas podem ser canceladas | Para as pagas, use um reembolso ou um ajuste. |
| Detalhes do vendedor ausentes nas faturas | Não preenchido | Preencha Seller details em System › Settings › General › Seller & invoicing. |
| Crédito / débito recusado | O valor é zero ou superior a $100,000 | Use um valor entre 1 cent e $100,000. |
| Um pagamento mostra Pending por muito tempo | Webhook ausente | Consulte Gateway events e reexecute. |