Artigos sobre: Configurações

S2S Postback

O Postback, também conhecido como S2S (Server-to-Server tracking) é uma forma de enviar automaticamente informações de conversão da sua loja Cartpanda para plataformas externas, como Redtrack, UTMify, Voluum, entre outras.

Isso permite acompanhar o desempenho das campanhas de tráfego, atribuir comissões corretamente para afiliados e manter suas ferramentas sincronizadas com os resultados da loja.

Quando o Postback é enviado?

Você pode configurar a Cartpanda para disparar postbacks nos seguintes momentos:

Evento	Quando acontece
`initiate_checkout`	Quando o cliente inicia o checkout
`initial_sale`	Quando o pedido é finalizado com sucesso
`upsell`	Quando uma oferta de upsell é aceita

Esses eventos podem ser ativados ou desativados individualmente na sua integração.

Promolink

O promolink é o endereço eletrônico (URL) que será utilizado para a promoção do produto nas plataformas de marketing. Ou seja, é o link de campanha.
Se você é produtor, ele será o link do produto + click ID.
Se você é afiliado, ele será o link de afiliado do produto (link contendo seu afid) + click ID.
Algumas plataformas de marketing geram esse link automaticamente já com o click ID e outros parâmetros.

Postback URL

Esse link funciona como um receptor das conversões e informações de venda. Ele é fornecido pela plataforma de marketing que estiver utilizando e é por meio dele que o nosso sistema fará o envio para que suas campanhas sejam devidamente atualizadas.

Na etapa de configuração da integração, siga as instruções para utilizar adequadamente.

Como funciona na prática?

1. Você gera um link com o parâmetro `cid`

Esse link é usado em campanhas e anúncios, com o parâmetro cid indicando o ID do clique.

https://sualoja.com/checkout:123456?cid=CLIQUE123

Esse cid será usado pela Cartpanda para vincular o clique à conversão.

2. Você insere a URL de postback na Cartpanda

A Cartpanda substitui os parâmetros dinâmicos na URL sempre que um evento ocorrer.

Exemplo de URL:

https://domain.com/postback?click_id={cid}&amount={total_price}&type={order_type}&product={product_name}&client_email={email}&affiliate_commission={amount_affiliate}

E se o clique não tiver cid?

Existe uma opção na Cartpanda que permite que o postback seja enviado mesmo se o cid estiver em branco. Basta ativar o toggle na configuração da integração.

E se houver múltiplos produtos ou upsells?

A Cartpanda envia postbacks separados para cada produto com afiliação, mesmo que tenham afids diferentes.
Exemplo:

Produto A com afid 123
Produto B (upsell) com afid 456

→ Dois postbacks são enviados, um para cada afiliação.

Primeiro Passo: Criando a integração

Todo o rastreamento de afiliados — Pixel e S2S — agora fica em: Admin → Rastreamento → Affiliate Tracking (Pixel & S2S)

No topo da página, você pode alternar entre:

View as Affiliate (sendo afiliado)
View as Vendor (sendo produtor do produto)

Isso facilita a gestão e separa informações de maneira segura.

Segundo Passo: Configuração

Na tela de nova integração, você deverá preencher corretamente o formulário com as informações solicitadas.

Nome	Função
Nome e Serviço	esse você pode preencher como preferir, são identificadores para melhor identificação caso você trabalhe com múltiplas integrações.
Moeda	nesse campo você deve definir em qual moeda você deseja que os valores sejam enviados no postback. O sistema irá converter para moeda selecionada: USD, EUR, BRL ou no caso da opção: “Não converter valores” serão enviados os valores na moeda da venda.
Aplicar para	defina nessa seção as regras para ativação e envio do postback de acordo com produtos específicos, coleções ou para todos os produtos (sempre).

⚠️ Postback URL

Essa etapa é a mais importante para garantir o bom funcionado da integração. Aqui definiremos a URL para onde o sistema enviará as conversões e informações da venda.

O postback URL é composto por: promolink + click ID + parâmetros com informações da venda encadeados.
Os parâmetros disponíveis para uso estão indicados abaixo do postback URL, e devem ser encadeados com o símbolo & após o click ID.
Exemplo: https://domain.com/postback?click_id={cid}&amount={total_price}&type={order_type}&product={product_name}&client_email={email}&affiliate_commission={amount_affiliate}.

Controle de Dados Pessoais (PII)

Para reforçar a segurança e conformidade com políticas de privacidade, a Cartpanda atualizou o envio de dados sensíveis nos postbacks S2S.

Os parâmetros relacionados a informações pessoais do cliente — como {first_name}, {last_name}, {email} e {phone_number} — agora só são incluídos quando o rastreamento em nível de vendedor (vendor-level tracking) estiver ativado para o afiliado.

Caso o rastreamento em nível de vendedor esteja desativado, esses parâmetros não serão enviados no postback, mas todos os demais parâmetros permanecem funcionais, garantindo a atribuição correta de conversões e comissões sem expor dados pessoais.

Essa atualização visa garantir conformidade com as normas de proteção de dados (como LGPD e GDPR) e proteger informações sensíveis de consumidores em integrações com plataformas externas.

Ativação e notificações

Por último, você deverá ativar a chave para garantir que a integração está ligada e funcional e configurar quais eventos serão registrados.

Também é possível incluir um e-mail para receber notificações em caso de erros no envio dos postbacks a URL configurada.

Terceiro Passo: testando a integração

Nesta etapa, com sua integração já configurada e salva, iremos validar a conexão com seu postback URL para garantir que está tudo pronto para rodar as campanhas de marketing.

Testando a conexão

Você deverá acessar novamente a integração em Admin > Rastreamento e Script > S2S Tracking.
Clique no título da integração que deseja testar.

No fim da página, clique no botão “Testar conexão” e um pop up será aberto.

Aqui você poderá inserir o promolink fornecido pela sua plataforma de marketing já com o click ID, ou você poderá inserir um link de checkout do seu produto na Cartpanda incluindo um click ID ao final: ?cid=algum-click-id.

— Atenção: algumas plataformas de marketing apenas retornarão sucesso no teste de conexão caso você utilize o promolink com um click ID válido fornecido por eles.

Clique em testar e verifique o resultado.

a. Caso esteja tudo bem, uma mensagem de sucesso será exibida na tela.
b. Caso tenha algum problema com o postback URL, o erro técnico será mostrado.

Testando com pedidos

Após garantir que a conexão está funcional, você poderá validar complemente a integração realizado um teste de ponta a ponta, ou seja, você ira abrir o promolink como um cliente e irá finalizar uma compra na Cartpanda.

Para realizar pedidos teste na Cartpanda, você deverá seguir essas instruções.

Lista de parâmetros para o S2S Postback URL

Informação	Parâmetro	Descrição	Exemplo
Click ID	`{cid}`	ID usado pelo sistema de rastreamento para atribuir a compra a um clique.	`123456789`
Chave da campanha	`{campaignkey}`	Chave opcional para identificar campanhas distintas.	`Facebook Campaign`
País	`{country}`	País da compra, com base no IP do comprador.	`Germany`
Valor do afiliado	`{amount_affiliate}`	Valor da comissão paga ao afiliado.	`€15.03`
Moeda	`{currency}`	Moeda em que a compra foi realizada.	`EUR`
ID do produto	`{product_id}`	Identificador interno do produto.	`62686`
Nome do produto	`{product_name}`	Nome do produto comprado.	`Cápsula de cafeína`
Tipo do pedido	`{order_type}`	Fase da venda: inicio do checkout, venda inicial ou upsell.	`initiate_checkout`, `initial_sale`, `upsell`
Posição do upsell	`{upsell_no}`	Posição da oferta no funil de vendas.	`3` (= terceiro upsell)
Slug da loja	`{shop_slug}`	Identificador único da loja na Cartpanda.	`sua-loja`
Slug do afiliado	`{affiliate_slug}`	Identificador único do afiliado na Cartpanda.	`AnnasShop`
Código do afiliado	`{afid}`	Código único de afiliação do produto.	`gmHk9k`
Pagamento teste	`{is_test}`	Indica se o pedido é um teste (`1`) ou real (`0`).	`1`
Data e hora	`{datetime_unix}{datetime_full}{datetime_utc}`	Data e hora da conversão em diferentes formatos.	`1570216877`
Texto aleatório	`{random}`	String aleatória usada para evitar cache.	`2nc91mx82`
E-mail	`{email}`	E-mail do cliente.	`cliente@mail.com`
Primeiro nome	`{first_name}`	Primeiro nome do cliente.	`José`
Último nome	`{last_name}`	Último nome do cliente.	`Souza`
Telefone	`{phone_number}`	Número de telefone do cliente.	`5511999119988`

Visibilidade de Regras

Para melhorar a privacidade:

Produtores só conseguem ver regras que se aplicam a um único produto.
Regras configuradas para todos os produtos ou múltiplos produtos ficam visíveis apenas para o afiliado.
Afiliados têm modo completo de criação e edição.

Essa mudança evita exposição indevida de campanhas e segmentações.

Vídeo de exemplo com integração a Redtrack

Atualizado em: 27/11/2025

Este artigo foi útil?

Obrigado!