Capacidade compartilhada
A mensalidade é a soma dos pacotes contratados. Cada número usa uma vaga, distribuída livremente entre os clientes do parceiro.
Como contar a capacidade
Um cliente com cinco números usa cinco vagas. Cinco clientes com um número cada também usam cinco vagas. Criar um cadastro de cliente não gera cobrança.
Conexões em andamento reservam uma vaga. Tentativas simultâneas não podem ultrapassar o limite. Uma vaga só é liberada depois da confirmação da remoção remota.
Pacotes mensais
| Pacote | Números | Mensalidade |
|---|---|---|
| Partner 4 | 4 | R$ 99,90 |
| Partner 25 | 25 | R$ 499,90 |
| Partner 100 | 100 | R$ 1.500,00 |
É possível repetir ou combinar pacotes. Dois pacotes Partner 4 dão oito números por R$ 199,80 por mês. A seleção representa o total desejado após a alteração.
Contratação e renovação
A primeira contratação concluída no Checkout, com forma de pagamento cadastrada, inicia três dias corridos de teste sem mensalidade inicial. A primeira cobrança automática é prevista para o fim desse período. É possível cancelar antes do término para evitar a primeira mensalidade. Contratações posteriores e mudanças de pacotes não reiniciam esse período. Análises da Meta não prorrogam o prazo automaticamente. Aumentos em ciclos pagos podem gerar cobrança proporcional imediata. O valor é apresentado na prévia; a capacidade só aumenta após a confirmação da Stripe.
Reduções entram na próxima renovação. Antes de agendar, o uso deve caber na capacidade futura. Novas conexões respeitam esse limite enquanto a redução estiver agendada.
Expansão sem excedente automático
Ao atingir a capacidade, novas conexões ficam bloqueadas até o parceiro contratar mais pacotes. Não há cobrança por cliente extra nem contratação automática. Desconectar um número libera uma vaga, mas não cancela o pacote mensal.
Pagamento pendente e encerramento
Se o cartão recusar um aumento, os novos números não são liberados. O Portal exibe a fatura pendente para concluir o pagamento. Repetir a confirmação da mesma prévia reutiliza a mesma compra.
Encerrar a assinatura agenda o cancelamento para o fim do período contratado. É possível manter a assinatura antes dessa data. O encerramento confirmado bloqueia novas conexões e agenda a remoção das conexões existentes. A recuperação financeira não reconecta números já removidos automaticamente.
API de cobrança
Use a API do Partner com JWT autenticado ou chave do parceiro com escopo de cobrança. Nunca envie valores monetários escolhidos pelo navegador.
| POST | Uso |
|---|---|
| get-partner-stripe-billing-summary | Pacotes, uso, capacidade, pagamento pendente e renovação |
| preview-number-pack-change | Recebe packs com code e quantity e retorna uma prévia vinculada ao usuário |
| apply-number-pack-change | Recebe quote_id e confirma a mesma compra de forma idempotente |
| cancel-number-pack-change | Cancela a redução agendada |
| create-stripe-customer-portal-session | Abre faturas e forma de pagamento; não permite trocar ou cancelar pacotes por fora do Partner |
| cancel-stripe-subscription / resume-stripe-subscription | Agenda encerramento ou mantém a assinatura |
{"packs":[{"code":"partner_numbers_4","quantity":2},{"code":"partner_numbers_25","quantity":1}]}Esse exemplo contrata 33 números por R$ 699,70 por mês. A prévia informa o valor devido agora e a próxima mensalidade. Trocas e cancelamentos são confirmados pelo Portal do Partner, que valida a capacidade e o período contratado. As antigas rotas de alteração de plano, faturas manuais e excedente estão bloqueadas neste modelo.
Produção usa Stripe em modo live. O stage usa Stripe de teste e banco separado; chaves, preços, clientes de cobrança e assinaturas não são intercambiáveis entre os ambientes. O cadastro da Meta usa o app exclusivo do Partner; a conexão exige permissões e validação do número na Meta.