Visão geral
A Flipkart não envia webhooks, então a AffClix faz o caminho inverso: importa seus pedidos pela API do Flipkart Affiliate a cada hora. Cada link de saída para a Flipkart leva seu Tracking ID da Flipkart (affid) e o ID de clique da AffClix em um dos parâmetros de repasse da Flipkart (affExtParam1 ou affExtParam2). A Flipkart devolve esse ID de clique em cada pedido, e é assim que o pedido é vinculado ao parceiro e à campanha.
Depois, os pedidos seguem o mesmo fluxo de qualquer outra loja: atribuição, deduplicação, seus filtros de pedidos, comissão e postbacks aos parceiros.
Por que esta integração é importante
- Pague os parceiros por vendas reais na Flipkart — a comissão é calculada sobre o valor do pedido informado pela Flipkart.
- Cancelamentos tratados automaticamente — um pedido cancelado ou devolvido estorna a comissão automaticamente.
- Nenhum webhook para configurar — a Flipkart só precisa de um Tracking ID e de um token de API.
- Pedidos com vários itens contados uma vez — a Flipkart informa cada item separadamente; a AffClix os agrupa em um único pedido, comissionado uma só vez.
- Mudanças de status capturadas — cada sincronização relê os últimos sete dias, então um pedido que passa de provisório para aprovado ou cancelado é atualizado.
- Feed de produtos incluído — o Sync Products importa o catálogo da Flipkart para que os parceiros criem links diretos.
Pré-requisitos
- Um plano da AffClix que inclua E-commerce — o menu Integrations → E-commerce.
- Uma conta aprovada no Flipkart Affiliate, com acesso à API.
- Seu Tracking ID e seu token de API da Flipkart (etapa 1).
- Um anunciante na AffClix para ser dono da loja — ele vê os pedidos e as comissões no próprio portal.
- Uma campanha cuja URL de destino aponte para a Flipkart e leve o ID de clique (etapa 3).
Etapa 1: Obtenha seu Tracking ID e seu token de API na Flipkart
Entre no Flipkart Affiliate
Faça login no painel do Flipkart Affiliate com a conta que recebe a comissão.
Copie o Tracking ID
Seu Tracking ID aparece no painel. Ele também é o valor de affid nos seus links da Flipkart.
Gere um token de API
Abra a seção API e gere (ou copie) seu token. Mantenha-o em sigilo — ele dá acesso de leitura aos seus relatórios de pedidos.
Etapa 2: Adicione a integração da Flipkart na AffClix
Abra as integrações de e-commerce
Acesse Integrations → E-commerce, abra a aba Integrations e clique em Add Integration.
Escolha a Flipkart
Selecione o bloco Flipkart. A Flipkart funciona só por importação, então não há card de webhook para preencher.
Dê um nome à loja e escolha o dono
Informe um Integration Name, como Flipkart – Índia, e escolha o anunciante em Store Owner.
Informe as credenciais
Cole o Tracking ID e o API Token. Em Click ID Parameter, escolha qual parâmetro de repasse leva o ID de clique da AffClix — affExtParam1 por padrão. O outro é lido como sub ID 1.
Revise as regras de pedidos e salve
Confira a janela de atribuição, a moeda e os filtros de pedidos, e clique em Create Integration. Na página de edição da loja, Test Connection consulta a API da Flipkart para confirmar as credenciais.
Etapa 3: Envie o tráfego dos parceiros com o ID de clique
A atribuição depende de cada link da Flipkart levar seu Tracking ID e o ID de clique da AffClix. Configure isso uma vez na URL de destino da campanha; os links de rastreamento dos parceiros passam a incluí-lo automaticamente.
Defina a URL de destino da campanha
Use a página da Flipkart como URL de destino e adicione affid=SEU_TRACKING_ID&affExtParam1={click_id}, por exemplo https://www.flipkart.com/…?affid=seuid&affExtParam1={click_id}. Se você escolheu affExtParam2 na etapa 2, use-o.
Teste um link
Abra o link de rastreamento de um parceiro e confira se a URL da Flipkart de chegada mostra um ID de clique real no lugar de {click_id}.
A Flipkart só devolve o que estava no link. Um pedido vindo de um link sem o ID de clique não pode ser vinculado a um parceiro.
Etapa 4: Sincronize os pedidos e confira o resultado
Aguarde a sincronização horária ou rode uma agora
Os pedidos são importados a cada hora. Para importar na hora, abra a loja e clique em Sync Orders.
Confira os pedidos
Abra a aba Orders do E-commerce. Cada pedido da Flipkart aparece uma vez, com valor, status e o parceiro creditado.
Aprove ou deixe o período de retenção correr
Com Paid orders only ativado (padrão), pedidos provisórios aguardam a aprovação da Flipkart. Depois, a comissão segue suas configurações de aprovação.
Exemplo real
Um site de ofertas divulga a liquidação de eletrônicos da Flipkart pela AffClix. A marca da campanha paga aos parceiros 4% de cada pedido aprovado.
- Um comprador clica no link de um parceiro e chega à Flipkart com
affid=dealsco&affExtParam1=seguido do ID de clique da AffClix. - O comprador pede fones e uma capa na mesma compra, por ₹6.200. A Flipkart informa dois itens com o mesmo ID de pedido; a AffClix os agrupa em um único pedido de ₹6.200.
- O pedido começa provisório, então aguarda. Quando a Flipkart o aprova, a sincronização seguinte registra uma venda e uma comissão de ₹248 para o parceiro.
- Uma semana depois, o comprador devolve os fones e a Flipkart marca o pedido como cancelado. A sincronização seguinte estorna a comissão.
Resultado: o parceiro recebe pela venda que a Flipkart confirmou, e a comissão some quando a venda some — sem ninguém editar planilha.
Gerenciar e monitorar a integração
- Última sincronização — a página da loja mostra quando os pedidos foram importados pela última vez e a mensagem de erro da Flipkart se a última importação falhou.
- Sync Orders — importe agora em vez de esperar a execução horária; a mesma janela de sete dias é relida.
- Test Connection — pede à Flipkart que confirme que o Tracking ID e o token continuam válidos.
- Sync Products — importa o catálogo da Flipkart para o seu feed de produtos.
- Pausar — deixar a integração inativa interrompe a sincronização sem perder configurações nem pedidos.
Como os status de pedido da Flipkart são tratados
A Flipkart informa um status por pedido. A AffClix transforma cada um em um evento de pedido:
| Status na Flipkart | O que a AffClix faz |
|---|---|
| tentative | Registra o pedido como pendente. Com Paid orders only ativado, ainda não há comissão. |
| approved | Registra o pedido como pago e cria a comissão. |
| cancelled / returned | Registra um reembolso e estorna qualquer comissão já criada. |
Solução de problemas
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| Test Connection falha | O Tracking ID ou o token de API está errado, ou o token foi gerado de novo. | Copie os dois novamente no Flipkart Affiliate e salve. |
| Pedidos chegam sem parceiro | O link não levava o ID de clique, ou o Click ID Parameter selecionado está errado. | Confira a URL de destino da campanha (etapa 3) e se o parâmetro é o mesmo dos seus links. |
| Um pedido aparece mas não gera comissão | Ainda está provisório e Paid orders only está ativado. | Aguarde a aprovação da Flipkart; a sincronização seguinte cria a comissão. |
| Uma mudança de status antiga não foi capturada | A mudança ocorreu mais de sete dias após o pedido. | Rode Sync Orders; peça ao suporte para ampliar o período de releitura em uma recuperação pontual. |
Conclusão
Com a Flipkart conectada, as vendas no marketplace são acompanhadas como em qualquer outra loja: cada pedido com um ID de clique da AffClix é creditado ao parceiro certo em até uma hora, e cancelamentos estornam a comissão automaticamente.
A Flipkart só informa pedidos vindos de links que levavam seu Tracking ID. Garanta que toda campanha que aponta para a Flipkart use a URL de destino da etapa 3.
Relacionados: Amazon Associates · Shopify · Macros de rastreamento