Conta
Planos e cobrança
O plano é pago antes e abre o mês com os créditos dele. Quando a cota acaba, nada é cobrado sem você pedir.
Os valores de cada plano, dos pacotes avulsos e dos créditos por produto são definidos no contrato.
Planos de API#
| Plano | Capacidade |
|---|---|
| Sellume API Base | máquinas compartilhadas, com cota de gerações simultâneas |
| Sellume API Growth | máquina própria |
| Sellume API Business | máquina própria maior e prioridade de fila |
| Sellume API Enterprise | sob medida: cota e preço por contrato, só com a equipe do Sellume |
Cada plano define também os limites técnicos: pedidos por minuto, gerações e vídeos simultâneos.
Pago antes#
- O plano é uma assinatura mensal paga antes. A fatura paga abre o ciclo com os créditos do plano.
- Os créditos do plano são a cota do mês e também o teto: não existe excedente cobrado depois.
- O crédito do plano vence no fim do ciclo (não acumula).
- Fatura do plano em atraso além da carência pausa a integração; pagar retoma na hora. Ver Atraso no pagamento.
Quando a cota acaba#
Bateu o teto: o uso passa a sair do crédito avulso guardado. Sem crédito avulso, os pedidos que gastam crédito respondem 402 INSUFFICIENT_CREDITS, sem cobrar nada, até que você:
- compre um pacote avulso — pago na hora, na página segura de pagamentos; o crédito não vence; ou
- espere o próximo ciclo.
O crédito avulso custa mais que o crédito do seu plano e que o do plano de cima. Comprou pacote avulso em 2 ciclos seguidos? O portal sugere subir de plano (nada muda sozinho; veja Subir de plano).
Pacote avulso pela API#
POST/recargas (escopo creditos:comprar, só chave de API) devolve o link da página segura de pagamentos. Nada é cobrado nem concedido nesta chamada: os créditos entram quando o pagamento é confirmado (extrato recarga).
curl -s -X POST $B/recargas -H "Authorization: Bearer $K" -H 'content-type: application/json' \
-d '{"pacote":"avulso_1000"}'Os pacotes disponíveis vêm de GET/plano, em recarga.pacotes. No teste não há cobrança.
Subir de plano: na hora#
Subir de plano vale no mesmo dia. Como funciona, passo a passo:
- Você pede a subida no portal (Plano › Pedir subida, escolhendo o plano) ou ao suporte do Sellume.
- O time do Sellume aplica a subida — normalmente no mesmo dia útil. Você recebe e-mail quando ela é aplicada.
- O plano novo é cobrado inteiro, na hora, na mesma forma de pagamento da assinatura. Não existe valor proporcional: nem desconto pelos dias que faltavam do plano anterior, nem cobrança "da diferença".
- O ciclo recomeça nesse dia. A partir daí a renovação passa a ser todo mês nessa data.
- Os créditos do plano novo entram inteiros no saldo assim que o pagamento é confirmado.
- O que sobrou do plano anterior continua seu e pode ser usado até a data em que já venceria (o fim do ciclo antigo). O crédito avulso guardado continua sem vencer.
Exemplo. Você está no Base (3.000 créditos/mês, ciclo de 1º a 30) e no dia 20 ainda tem 800 créditos. Pede o Growth (9.000 créditos/mês) e a subida é aplicada no dia 20: o Growth é cobrado inteiro no dia 20, o novo ciclo vai do dia 20 ao dia 20 do mês seguinte, o saldo passa a ser 9.000 + 800, e os 800 do Base podem ser usados até o dia 30.
Se o pagamento do plano novo não for confirmado (cartão recusado, por exemplo), nada muda: o plano atual continua como estava.
Descer de plano: no próximo ciclo#
Descer de plano é pedido no portal e vale só no próximo ciclo: nada é cobrado nem muda agora; até a renovação, o plano e a cota atuais continuam valendo, e a renovação já vem no plano menor. Uma troca pendente por vez, que pode ser desfeita antes da renovação. O Enterprise é combinado com a equipe do Sellume.
Agência: a descida só pode ser agendada se a soma dos planos dos seus clientes couber no plano menor — o portal mostra quanto reduzir.
Atraso no pagamento#
- Fatura do plano não paga: a contagem da carência do contrato começa.
- Passou da carência: a integração é pausada (a API responde
403INTEGRATOR_PAUSED). Pagar a fatura retoma na hora. - 30 dias pausada sem pagamento: a integração é desativada — a API recusa, o portal fica só para consulta e, nas agências, os clientes não acessam. Nada é apagado. Fale com o suporte do Sellume para regularizar.
Cancelar#
Para cancelar, faça o pedido no portal (Plano › Pedir cancelamento). O time do Sellume fala com você e conclui (no fim do ciclo, sem nova cobrança, ou na data combinada). Você pode exportar os seus dados antes.
Como os créditos são gastos#
- Primeiro o crédito do plano do mês (que vence antes).
- Depois o crédito avulso (que não vence).
- O pedido reserva os créditos; a cobrança acontece na entrega. Entrega parcial cobra só o entregue.
- Falha do Sellume devolve os créditos.
- Produto reprovado na conferência nunca reserva crédito.
- No teste (
sk_test_) nada é gasto, salvo as gerações com"modo": "real", que gastam só os créditos de teste.
Créditos de teste#
Para homologar a integração antes de contratar, o Sellume pode liberar créditos de teste para o seu ERP (valor combinado com a equipe comercial).
- Aparecem só como créditos de teste: em
creditosDeTestede GET/saldo, no extrato (tipo: creditos_de_teste) e no portal. - Pagam só gerações reais no ambiente de teste (
sk_test_com"modo": "real"); nunca pagam produção e não entram na cota do plano. - Valem por prazo fixo (em geral 60 dias da liberação), até a data de
creditosDeTeste.venceEm, e não renovam: ao vencer, o saldo de teste zera. - Não viram crédito de produção nem são reembolsáveis.
Consultas#
| Endpoint | O que traz |
|---|---|
GET/saldo | créditos disponíveis, reservados, crédito avulso guardado, plano e ciclo aberto |
GET/cota-do-mes | cota do ciclo, usado, restante, percentual, se bateu o teto e se comprou avulso |
GET/plano | plano atual, troca pendente (descida agendada ou subida aguardando o pagamento), sugestão de subida e pacotes avulsos |
GET/planos | planos disponíveis e o movimento possível a partir do atual |
GET/extrato | cada movimento por conta, produto e geração |
Enquanto os valores forem de exemplo (ambiente de teste), valoresDeExemplo vem true.
Avisos de cota#
O aviso cota.alerta chega (com alerta no portal e e-mail) em 70% e 90% da cota e quando bate o teto, com gatilho = cota_70, cota_90 ou teto. O aviso creditos.baixos chega quando o saldo fica abaixo do limite de alerta. Veja Avisos.