Pular para o conteúdo
sellumeDOCS · INTEGRADORES Portal do integrador

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#

PlanoCapacidade
Sellume API Basemáquinas compartilhadas, com cota de gerações simultâneas
Sellume API Growthmáquina própria
Sellume API Businessmáquina própria maior e prioridade de fila
Sellume API Enterprisesob 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).

bash
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:

  1. Você pede a subida no portal (Plano › Pedir subida, escolhendo o plano) ou ao suporte do Sellume.
  2. O time do Sellume aplica a subida — normalmente no mesmo dia útil. Você recebe e-mail quando ela é aplicada.
  3. 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".
  4. O ciclo recomeça nesse dia. A partir daí a renovação passa a ser todo mês nessa data.
  5. Os créditos do plano novo entram inteiros no saldo assim que o pagamento é confirmado.
  6. 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#

  1. Fatura do plano não paga: a contagem da carência do contrato começa.
  2. Passou da carência: a integração é pausada (a API responde 403 INTEGRATOR_PAUSED). Pagar a fatura retoma na hora.
  3. 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#

  1. Primeiro o crédito do plano do mês (que vence antes).
  2. Depois o crédito avulso (que não vence).
  3. O pedido reserva os créditos; a cobrança acontece na entrega. Entrega parcial cobra só o entregue.
  4. Falha do Sellume devolve os créditos.
  5. Produto reprovado na conferência nunca reserva crédito.
  6. 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 creditosDeTeste de 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#

EndpointO que traz
GET/saldocréditos disponíveis, reservados, crédito avulso guardado, plano e ciclo aberto
GET/cota-do-mescota do ciclo, usado, restante, percentual, se bateu o teto e se comprou avulso
GET/planoplano atual, troca pendente (descida agendada ou subida aguardando o pagamento), sugestão de subida e pacotes avulsos
GET/planosplanos disponíveis e o movimento possível a partir do atual
GET/extratocada 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.