Bem-vindo à Toktus

Aqui você encontra a documentação técnica da Toktus, a plataforma para criadores e empresas digitais venderem cursos, eventos, assinaturas, e-books e produtos físicos — com checkout personalizado, gestão de clientes, área de membros, coprodutores e pagamentos integrados, no Brasil e no exterior.

A Toktus é mais que uma API. Esta documentação cobre especificamente a Toktus API — o braço de infraestrutura da plataforma, usado tanto pelo nosso próprio dashboard quanto por integradores externos que precisam embutir pagamentos e gestão de produtos em sistemas próprios.

1. O que é a Toktus

A Toktus é uma plataforma de comercialização de produtos digitais. Cobrimos toda a jornada do criador: cadastro de produtos, criação de página de checkout, processamento de pagamentos, distribuição em área de membros, gestão de afiliados e coprodutores, e analytics de conversão.

Atendemos tanto criadores que vendem exclusivamente no Brasil — via Pagar.me, Asaas, Mercado Pago e PagSeguro — quanto operações internacionais ou multi-moeda via Stripe, com cobrança em mais de 135 moedas e métodos locais em dezenas de países.

Por trás de tudo isso roda uma infraestrutura modular, e cada módulo é exposto como API para quem quiser consumir diretamente.

Você pode usar a Toktus de três formas:

1. Como plataforma fechada — entre no painel, crie seus produtos, gera seu checkout e começa a vender em minutos. Sem código.
2. Como infraestrutura via API — integra a Toktus API ao seu próprio sistema, e-commerce ou app. Você mantém sua interface; nós cuidamos do roteamento de pagamentos, gestão de assinaturas e webhooks.
3. Modelo híbrido — usa o painel da Toktus para gestão administrativa e chama a API para personalizações pontuais.

2. Produtos da Toktus

Painel Toktus

Dashboard web em app.toktus.com onde você cadastra produtos, configura checkout, acompanha vendas, gerencia coprodutores e cupons, e acessa relatórios. É o produto principal para quem não quer escrever uma linha de código.

Toktus Checkout

Páginas de pagamento personalizáveis com domínio próprio, pixels de tracking (Meta, Google, TikTok), order bumps, upsells e testes A/B. Cada checkout é vinculado a um produto ou bundle e pode ser embutido no seu site ou usado standalone. Suporta cobrança em real e em moedas estrangeiras.

Área de Membros

Plataforma de distribuição de conteúdo digital para os compradores de cursos, e-books e assinaturas. Login com e-mail, acesso por nível, controle de progresso e drip content.

Toktus API

A camada de infraestrutura — esta documentação. Expõe endpoints REST para:

• Processar cobranças via Stripe (global), Pagar.me, Asaas, Mercado Pago e PagSeguro (Brasil e LATAM)
• Tokenizar e armazenar cartões de crédito
• Gerenciar clientes, assinaturas e estornos
• Configurar webhooks normalizados
• Dividir pagamentos entre coprodutores
• Rotear cobranças com fallback automático entre gateways

Você usa a API quando precisa de controle programático que o painel não oferece, ou quando está construindo um sistema próprio que apenas terceiriza a parte de pagamentos.

3. Sobre esta documentação

Esta documentação cobre apenas a Toktus API. Se você procura tutoriais sobre o painel, configuração de checkout ou criação de cursos, acesse a Central de Ajuda.

Aqui você encontra:

• Referência completa de todos os endpoints REST da API
• Guias passo a passo sobre autenticação, cadastro de credenciais e processamento de cobranças
• Exemplos prontos em cURL (SDKs oficiais em breve)
• Documentação de webhooks, códigos de erro e boas práticas de segurança

4. O que a API oferece

Pagamentos multigateway, no Brasil e no exterior

Suportamos cartão de crédito, cartão de débito, PIX e boleto via gateways brasileiros (Pagar.me, Asaas, Mercado Pago e PagSeguro), e cobrança internacional em mais de 135 moedas via Stripe. Você integra uma vez e roda em qualquer combinação de gateways e mercados.

Assinaturas

Motor completo de cobrança recorrente com pausa, cancelamento, reativação e troca de método de pagamento. Suporta cobrança em cartão ou boleto, intervalos customizáveis e gestão de inadimplência.

Roteamento e fallback

Configure uma fila ordenada de gateways e a Toktus tenta cada um em sequência até obter sucesso. Se a Stripe ficar indisponível ou recusar uma cobrança, o Pagar.me assume. Sem perder vendas por instabilidade. Útil também para rotear por região: brasileiros pelo Pagar.me, internacionais pela Stripe.

Coprodutores e splits

Divida automaticamente o valor de cada cobrança entre múltiplos recebedores. Essencial para marketplaces, infoprodutores com afiliados e plataformas multi-tenant.

Webhooks normalizados

Cada gateway envia eventos em formatos diferentes. A Toktus normaliza tudo em um único schema, valida assinatura criptográfica e repassa para a URL que você configurar. Implemente o handler uma única vez.

Tokenização e armazenamento de cartões

Cartões de crédito são tokenizados e armazenados de forma segura para reuso. Aceita tokens gerados nos SDKs oficiais dos gateways (Stripe.js, MercadoPago.js, PagBank.js) ou dados brutos quando o gateway permite.

Segurança no padrão da indústria

Credenciais criptografadas com AES-256-GCM em repouso, derivação por scrypt, TLS 1.2+ em todo transporte, RLS no banco. Chaves nunca são retornadas após o cadastro.

Sandbox completo

Todos os gateways suportados oferecem ambiente de homologação. A Toktus identifica automaticamente o ambiente pela credencial cadastrada. Cartões e dados de teste estão documentados em cada guide.

5. Comece por aqui

Em caso de dúvidas

Por enquanto, todo nosso atendimento acontece pelo e-mail [email protected], seja para dúvidas técnicas sobre a API, uso do painel, questões comerciais ou feedback sobre a documentação.

Antes de escrever, dá uma olhada no menu lateral — boa parte das dúvidas comuns já está respondida nos guides de autenticação, credenciais, webhooks, erros e segurança.

Quando escrever, ajuda muito incluir:

• O endpoint que você estava chamando
• O payload enviado (sem dados sensíveis como cartão completo)
• A resposta recebida da API
• O request-id retornado em respostas de erro

Com esses dados em mãos, conseguimos investigar e responder mais rápido.

Em breve teremos canais separados para suporte técnico, comercial e status da plataforma. Por ora, é tudo pelo [email protected].