Pular para o conteúdo

Para quem tem loja

Criar uma loja (assinar)

  • conta.<domínio>/assinar (escolher plano, seus dados, código do WhatsApp, pagamento)
  • Página de parceirosbotões dos planos

Quem chega pela página de parceiros escolhe um plano e cria a loja sozinho em conta.<domínio>/assinar, sem falar com ninguém. No fim, a loja existe e:

  • com cartão (e teste no preço): 7 dias grátis, acesso liberado na hora, primeira cobrança no cartão só no fim do teste;
  • com Pix à vista (só no anual) ou Pix Automático (quando liberado): sem teste; a primeira fatura sai na hora e a loja é liberada quando o pagamento confirma (webhook do Asaas ou “Já paguei”).

Formas de pagamento por ciclo

Ciclo Formas Teste grátis
Mensal Cartão de crédito · Pix Automático (quando liberado) Só no cartão
Anual Cartão (até 12x sem juros) · Pix à vista · Pix Automático (quando liberado) Só no cartão
  • Boleto não é oferecido na contratação nem em “Minha assinatura” (o código continua para a fatura que o Super Admin emitir à mão).
  • Pix Automático só aparece com billing.pixAutomatico.enabled ligada em Super Admin › Assinaturas (nasce desligada: o Asaas exige conta PJ com CNPJ ativo há 6 meses ou mais). Desligado, o mensal é só cartão e o anual é cartão ou Pix à vista.
  • As formas de cada ciclo vêm de GET /public/planos (formasDePagamento: { mensal, anual }) e da sessão do checkout (formasDePagamento do ciclo escolhido); o servidor recusa a forma que não vale para o ciclo.

Antes de começar

  • Um WhatsApp com DDD para receber o código de confirmação.
  • CPF ou CNPJ válido (vai na nota fiscal da assinatura).
  • Um e-mail que ainda não tenha acesso a uma loja no iLarika. Quem já tem loja entra em Minha assinatura para trocar de plano.

Passo a passo

  1. Escolha o plano e o ciclo. A vitrine vem de GET /public/planos (o que o Super Admin marcou como público e com preço ativo). Quando algum plano tem preço anual, aparece Mensal | Anual, com o anual escolhido: ele mostra o valor do ano, “equivale a R$ X/mês” e a economia sobre 12 mensalidades. Cada plano tem o botão Testar 7 dias (preço com teste) ou Escolher. Plano “sob consulta” (a Rede) não aparece aqui. O link da página de parceiros já chega com o plano e o ciclo (?plano=essential&ciclo=year); sem ciclo, vale o anual. Na tela de dados ainda dá para trocar entre mensal e anual, ou voltar em Trocar de plano. Trocar de plano ou de ciclo não perde o ref do afiliado, o cupom nem os utm_*.

  2. Seus dados: nome, nome da loja, e-mail (vira o login), WhatsApp, CPF/CNPJ, cidade/UF e a senha do painel (mínimo de 8 caracteres). Toque em Continuar. A conferência é a mesma no navegador e no servidor: o erro aparece embaixo do campo.

  3. Código do WhatsApp: 6 dígitos, vale 10 minutos, 5 tentativas; toque em Confirmar. Reenviar código só depois de 60 s. Sem o código, nada é criado.

  4. Pagamento (as formas do ciclo; com uma forma só, não há escolha):

    • Cartão, com teste (o preço tem 7 dias de teste e a cobrança está ligada): a tela diz “7 dias grátis — cadastre o cartão, cancele quando quiser antes do fim do teste e não paga nada”. Número, nome, validade, CVV, e o CEP e o número do endereço do titular (o Asaas pede). O cartão vai direto para o Asaas virar token (POST /creditCard/tokenize): o iLarika não guarda o número. A loja nasce em teste com o plano inteiro. No anual dá para escolher de 1x a 12x sem juros; a escolha fica guardada para a cobrança do fim do teste.
    • Cartão, sem teste (preço sem teste, cobrança desligada, ou quem já usou o teste e escolheu “Pagar agora com o cartão, sem teste”): a primeira fatura é cobrada no cartão na hora; aprovado, a loja abre.
    • Pix à vista (anual): sem teste. A loja é criada esperando o primeiro pagamento (fora do ar, painel bloqueado com “Quase lá: aguardando o primeiro pagamento”), e a fatura vem com o QR do ano todo. Pago, a loja é liberada sozinha. A renovação do ano seguinte chega como fatura para pagar.
    • Pix Automático (mensal ou anual, quando liberado): sem teste — a tela diz que o primeiro pagamento é agora. A fatura vem com o QR que paga a primeira fatura e autoriza as próximas (Jornada 3 do Asaas). A pessoa paga no app do banco e confirma a autorização; a loja é liberada quando o pagamento confirma, e as faturas seguintes são debitadas sozinhas no vencimento.
    • Plano com preço R$ 0: Criar minha loja cria a loja ativa, sem fatura. Plano sem preço ativo não é contratável.

    O botão diz o que vai acontecer: Começar meus 7 dias grátis (cartão com teste) ou Criar loja e pagar com cartão / Pix / Pix Automático. Sem teste, a primeira fatura vence em 2 dias.

  5. Pronto: com teste ou cartão aprovado, a pessoa entra direto na loja, sem digitar a senha (o painel abre sozinho no teste). Com Pix ou Pix Automático, a tela mostra o QR e confere a fatura a cada 5 segundos: quando o pagamento confirma, aparece “Pagamento confirmado” e o botão Entrar na minha loja. O link de entrada vale 10 minutos e uma vez só; depois, é o login normal com o e-mail e a senha criados.

O teste de 7 dias

  • Só com cartão cadastrado, e só com billing.enabled ligada: é a régua que emite a fatura do fim do teste (5 dias antes) e cobra o cartão no dia em que o teste acaba (passo D0), nunca antes. Com a cobrança desligada, a vitrine não promete teste e o cartão é cobrado na contratação.
  • 2 dias antes do fim, a loja recebe no WhatsApp e no e-mail: quando e quanto vai para o cartão, e que cancelando antes em Minha assinatura não paga nada (cancelar.md).
  • Cartão recusado no fim do teste: segue a régua de atraso (atraso-e-bloqueio.md) — novas tentativas, aviso e, depois da carência, a loja pausa.
  • Um teste por pessoa: CPF/CNPJ, e-mail, WhatsApp e o cartão (impressão digital HMAC do número, nunca o número) em trial_claims. Quem já usou vê “já usou o teste grátis” antes de qualquer coisa ser criada, com a opção de pagar agora.
  • Conferir o cartão antes do teste: com billing.trialCardCheck = preautorizacao (PlatformSetting), o cartão passa por uma pré-autorização de R$ 5 do Asaas (authorizeOnly), estornada na hora. Sem a preferência, vale só a tokenização (o Asaas recusa dados inválidos), e a autorização de verdade é a cobrança do fim do teste.

O que acontece por baixo

  • Uma CheckoutSession guarda o andamento (só o hash da senha e do código). Voltar à página retoma de onde parou; a sessão vale 48 h.
  • Ao concluir, uma transação cria loja + dono (a mesma implementação que o Super Admin usa), o contato de suporte verificado (o WhatsApp confirmado), a assinatura com a atribuição congelada (ref, utm_*, cupom) e, se for o caso, a fatura de ciclo e a cobrança. Repetir a conclusão devolve a mesma loja: a sessão nunca cria duas.
  • O cartão é tokenizado antes de a loja existir: cartão recusado não cria nada. Enquanto a assinatura não existe, a loja nasce fora do ar.
  • Na assinatura ficam só o token do cartão, o final, a bandeira e as parcelas (paymentMethod); renovações e a cobrança do fim do teste usam esse token. No Pix Automático fica a autorização a caminho (paymentMethod.pixAutomatico), que vira a forma de pagamento quando o banco do pagador confirma (webhook PIX_AUTOMATIC_RECURRING_AUTHORIZATION_ACTIVATED). No anual por Pix fica forma: pix (sem débito automático).
  • A loja nasce com AuditLog tenant.created (origem self_service) e um e-mail de boas-vindas com os primeiros passos.

Perguntas comuns

O nome da loja já existe? O endereço ganha um sufixo (bom-bar-2); o nome exibido continua o que a pessoa escreveu.

Não recebi o código. “Reenviar código” depois de 60 s; “Número errado? Recomeçar” volta ao formulário.

Posso criar sem WhatsApp? Não: é a única prova de que há alguém de verdade do outro lado, e é por ele que a cobrança avisa.

Se der errado

  • “Confira os campos destacados”: o erro está embaixo de cada campo.
  • “Este e-mail já tem acesso a uma loja”: entre em Minha assinatura (minha-assinatura.md) com esse e-mail.
  • “Código vencido. Peça outro.” ou “Muitas tentativas. Peça outro código.”: toque em Reenviar código.
  • “Confira os dados do cartão…” ou “Informe o CEP e o número do endereço do titular do cartão”: o cartão não foi enviado e nada foi criado.
  • “…já usou o teste grátis”: use Pagar agora com o cartão, sem teste ou outra forma de pagamento.
  • “Este plano é sob consulta”: fale com a gente pela página de parceiros.
  • Pagou o Pix e a tela não liberou: abra Abrir a página desta fatura e toque em Já paguei (veja minha-assinatura.md).