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.enabledligada 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 (formasDePagamentodo 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
-
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); semciclo, 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 orefdo afiliado, ocupomnem osutm_*. -
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.
-
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.
-
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.
- 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 (
-
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.enabledligada: é 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
CheckoutSessionguarda 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 (webhookPIX_AUTOMATIC_RECURRING_AUTHORIZATION_ACTIVATED). No anual por Pix ficaforma: pix(sem débito automático). - A loja nasce com
AuditLog tenant.created(origemself_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).
