Voltar para documentação
Integrações

Integração Ticto

Conecte sua conta Ticto ao Synchro Hub para receber vendas em tempo real e consolidar métricas no dashboard.

Visão geral

Ao integrar a Ticto, o Synchro Hub passa a:

  • Receber webhooks de vendas, reembolsos, chargebacks e movimentos de assinatura em tempo real.
  • Identificar reembolso e chargeback separadamente — cada um aparece com status próprio no dashboard, respeitando a forma como a Ticto distingue os dois.

Tempo estimado: 10 minutos. O que você vai precisar:

  • Conta Ticto com perfil de Produtor (ou Co-produtor com permissão).
  • Workspace já criado no Synchro Hub.

Pré-requisitos

  • Estar logado no Synchro Hub com um workspace selecionado.
  • Ter acesso ao painel da Ticto em dash.ticto.com.br.

Passo 1 — Gerar as credenciais de API na Ticto

  1. Entre em dash.ticto.com.br com sua conta de produtor.
  2. Acesse dash.ticto.com.br/api-credentials.
  3. Clique em Nova Credencial, dê um nome (ex.: Synchro Hub) e salve.
  4. A Ticto exibirá o Client ID e o Client Secret. Copie os dois — você vai colá-los no Passo 3.

Importante: nunca compartilhe o Client Secret. Ele dá acesso à sua conta Ticto via API.

Passo 2 — Conectar a plataforma no Synchro Hub

  1. No Beacon, acesse Configurações → Integrações → Fontes de Venda.
  2. Clique em + Adicionar Plataforma.
  3. Selecione Ticto e clique em Confirmar.
  4. O card da Ticto aparece com os status Ativa e Webhook não configurado.

Passo 3 — Salvar as credenciais (Client ID e Client Secret)

  1. No card da Ticto, clique em Atualizar credenciais.
  2. Cole o Client ID e o Client Secret copiados no Passo 1.
  3. Clique em Salvar.

O Synchro valida as credenciais em tempo real fazendo um token exchange OAuth com a Ticto. Se algo estiver errado, você verá uma mensagem de erro — nesse caso, gere uma nova credencial e tente de novo.

Passo 4 — Configurar o webhook no painel Ticto

Diferente de outras plataformas, a Ticto não permite que o Synchro registre o webhook automaticamente. Você precisa cadastrá-lo manualmente no painel.

  1. No card da Ticto no Beacon, clique em Configurar Webhook. Copie a URL do Webhook e o Token exibidos. O formato da URL é:

    https://api.synchrohub.com.br/v1/webhooks/ecommerce/ticto/{seu-integration-id}

  2. Em outra aba, abra dash.ticto.com.br e vá em TicTools → Webhooks.

  3. Clique no ícone de olho da pasta onde quer organizar o webhook e depois em + Adicionar.

  4. Preencha os campos:

    CampoValor
    TokenO token copiado do Beacon (Passo 4, item 1).
    Item handlingOrder Bump/Combo juntos — para o Synchro receber 1 webhook por venda com bumps.
    ProdutoSelecione o produto cujos eventos vão disparar.
    Endpoint URLA URL copiada do Beacon.
    Versão2.0 (a 1.0 é legacy).
    Formato de envioJSON (obrigatório).

  5. Marque os eventos recomendados:

    • Venda Realizada
    • Aguardando Pagamento
    • Boleto Impresso
    • Pix Gerado
    • Pix Expirado
    • Boleto Atrasado
    • Reembolso
    • Chargeback
    • Abandono de Carrinho (opcional — habilita a recuperação)
    • Cancelada (subscription) e Atrasada (subscription) se você vender assinatura

  6. Salve. A Ticto envia um POST de teste assim que você salva — se a credencial já foi salva no Beacon (Passo 3), o teste passa.

Importante: se a Ticto reportar falha 401 no POST de teste e você ainda não tinha salvado a credencial no Beacon, é esperado. Salve a credencial no Beacon e reenvie o teste pelo painel da Ticto.

Passo 5 — Ativar o webhook no Synchro Hub

  1. Volte para o modal Webhook Ticto no Synchro Hub.
  2. Clique em Ativar Webhook.

O card da integração passa a exibir Webhook ativo.

Verificação

Para confirmar que tudo está funcionando:

  1. Gere uma venda de teste na Ticto (use o ambiente mirror da Ticto ou um cupom de 100% em um produto seu).
  2. Abra Vendas no menu lateral do Synchro Hub.
  3. A venda deve aparecer em até 1 minuto após a aprovação na Ticto.

Limitações conhecidas

  • Webhook não-automático: a Ticto não expõe API pública para registrar webhook — por isso o Passo 4 é manual no painel.
  • Webhook de afiliação separado: a Ticto tem um webhook próprio para eventos de afiliação (AFFILIATION_CREATED, AFFILIATION_APPROVED, etc.) configurado em outra seção do painel. O Synchro ainda não ingere esse webhook — só comissões que chegam junto com a venda no webhook v2 são consolidadas.
  • Reembolso parcial: a Ticto não documenta refund parcial. O Synchro trata todo refunded como reembolso total da venda.

Solução de problemas

SintomaO que fazer
”Credenciais inválidas” ao salvarGere um novo par Client ID / Client Secret em dash.ticto.com.br/api-credentials.
POST de teste falhou com 401A credencial ainda não foi salva no Beacon. Conclua o Passo 3 e reenvie o teste pelo painel Ticto.
Nenhuma venda chega após horasConfira no painel Ticto se a URL está sem espaços, se a versão é 2.0 e se o formato é JSON.
Token inválido reportado no SynchroO token cadastrado no painel da Ticto precisa ser idêntico ao token mostrado no Beacon. Copie novamente direto do Beacon.
Recebo um webhook por bump em vez de 1No painel da Ticto, troque o Item handling para Order Bump/Combo juntos e salve.

Perguntas frequentes

Tenho vários produtos na mesma conta Ticto. Preciso configurar um webhook para cada? Sim. No painel da Ticto, o webhook é configurado por produto — repita o Passo 4 para cada produto, usando a mesma URL e o mesmo token do Beacon.

Posso reprocessar vendas antigas? A Ticto permite reenvio manual de webhooks pelo painel. Vendas anteriores à integração não são importadas automaticamente.

Como desconecto a integração? No card da Ticto, clique em Remover. Os dados também serão apagados do Synchro Hub. Lembre-se de remover ou desativar o webhook no painel da Ticto para evitar tentativas de entrega sem destino.