> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://help.cartpanda.com/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # 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). | ![](https://storage.crisp.chat/users/helpdesk/website/626e5bed518e1800/image_13952fd.png) ### ⚠️ 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}. ![](https://storage.crisp.chat/users/helpdesk/website/626e5bed518e1800/image_iso8yj.png) --- # 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. ![](https://storage.crisp.chat/users/helpdesk/website/-/6/2/6/e/626e5bed518e1800/image_1ef5zfa.png) --- # 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 1. Você deverá acessar novamente a integração em [Admin > Rastreamento e Script > S2S Tracking](https://accounts.cartpanda.com/settings/pixels). 2. Clique no título da integração que deseja testar. ![](https://storage.crisp.chat/users/helpdesk/website/626e5bed518e1800/image_1j7l2m9.png) 3. No fim da página, clique no botão “Testar conexão” e um pop up será aberto. ![](https://storage.crisp.chat/users/helpdesk/website/626e5bed518e1800/image_4c1tb1.png) 4. 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. ![](https://storage.crisp.chat/users/helpdesk/website/626e5bed518e1800/image_aqsmqv.png) 5. 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](https://ajuda.cartpanda.com/pt-br/article/como-fazer-um-pedido-de-teste-w07sgq/). --- # 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 ${youtube}[](mSA-z6TdSzg)