Integration logo
Setcom (Auto-post e campo personalizado usado por outro script)

Setcom (Auto-post e campo personalizado usado por outro script)

Setcom AutoPost CustomField Integration

Integração Setcom (Auto-post e campo personalizado usado por outro script)

O Setcom integra usando o callback Auto-post. Use esta integração caso esteja utilizando o Auto-post para outro propósito, como entrega digital ou registro de associação, e já use um campo personalizado para transferir algum dado.

Para integrar com o Setcom, você precisa do plugin Setcom, que já vem distribuído por padrão no PAP.

Configurando o plugin

Primeiro, você deve ativar o plugin Setcom em PAP > Menu inicial > Plugins. Após ativar o plugin, é necessário configurá-lo. Clique no botão Configurar. Você deve inserir seu nome de usuário e senha de comerciante que usa para acessar seu painel de comerciante. O identificador do comerciante está localizado em Setcom merchant panel menu superior > Minha conta > Aba Visão Geral. Também é necessário definir um separador. O valor padrão é ||.

Configure suas definições Setcom

Acesse seu painel de comerciante Setcom. No menu superior > Perfil > Preferências de Venda, selecione Preferências de Pagamento no Site. Certifique-se de que o Auto-post está ativado e que a URL do Auto-post está definida como https://URL_TO_PostAffiliatePro/plugins/Setcom/setcom.php.

Não se esqueça de salvar suas configurações.

Atualize os Botões

Agora adicione o seguinte código em TODOS os formulários de botão Setcom (Comprar agora, Adicionar ao carrinho e/ou Finalizar compra):

<input type="hidden" name="MerchCustom" value="abc" id="pap_ab78y5t4a">

Por exemplo:

<form action="https://www.setcom.com/secure/index.cfm" method="post">
  <input type="hidden" name="buttonaction" value="buynow">
  <input type="hidden" name="merchantidentifier" value="12345678920">
  <input type="hidden" name="liddesc" value="auticko">
  <input type="hidden" name="lidsku" value="a123">
  <input type="hidden" name="lidprice" value="150.00">
  <input type="hidden" name="lidqty" value="1">
  <input type="hidden" name="CurrencyAlphaCode" value="ZAR">
  <input type="hidden" name="LIDExpiry" value="1">
  <input type="hidden" name="ShippingRequired" value="0">
  <input type="hidden" name="IsVoucher" value="0">
  <input type="hidden" name="Option1Name" value="custom">
  <input type="hidden" name="Option1Value" value="oldCustom">
  <input type="hidden" name="MerchCustom" value="abc" id="pap_ab78y5t4a">
  <input type="image" src="https://www.setcom.com/www/graphics/cartbuttons/bn6.gif">
</form>

Após este formulário, você deve inserir:

<script id="pap_x2s6df8d" src="https://URL_TO_PostAffiliatePro/scripts/notifysale.php" type="text/javascript">
</script>
<script type="text/javascript">
    PostAffTracker.setAppendValuesToField('||');
    PostAffTracker.writeCookieToCustomField('pap_ab78y5t4a');
</script>

Integração com seu script

Agora o callback Auto-post está apontando para seu script. Este callback também precisa ser encaminhado para o script paypal.php do PAP, cuja URL é https://URL_TO_PostAffiliatePro/plugins/Setcom/setcom.php.

Caso seu script de processamento Setcom seja em PHP, você pode utilizar o seguinte código para isso. Você pode colocá-lo no início do seu arquivo de processamento:

/* Integração PAP */
 $ch = curl_init();
 curl_setopt($ch, CURLOPT_URL, "https://URL_TO_PostAffiliatePro/plugins/Setcom/setcom.php");
 curl_setopt($ch, CURLOPT_POST, 1);
 curl_setopt($ch, CURLOPT_POSTFIELDS, $_POST);
 curl_exec($ch);
/* fim da integração PAP */

Isso garantirá que todo o callback Auto-post será encaminhado sem afetar seu script original.

Integração com seu script – parte 2

O parâmetro personalizado está no formato 3rdPartySystemValue||PapValue. Para que o sistema de terceiros funcione corretamente, é preciso extrair o 3rdPartySystemValue do parâmetro personalizado. Para isso, adicione o seguinte código logo após a verificação do Auto-post do Setcom.

Assuma que na variável $custom_value você tem o valor customizado carregado do XML enviado pelo Setcom:

$separator = '||';

if ($custom_value!= '') {
      $explodedCustomValue = explode($separator, $custom_value, 2);
          if (count($explodedCustomValue) == 2) {
            $custom_value = $explodedCustomValue[0];
      }
}

Depois disso, você terá o valor original em $custom_value.

Você encontra informações mais detalhadas sobre a integração Setcom no Guia de Implementação Setcom.

Frequently asked questions

O que é a integração Setcom (Auto-post e campo personalizado) para o Post Affiliate Pro?

A integração com o Setcom permite conectar o processamento de pagamentos do Setcom ao Post Affiliate Pro usando callbacks de Auto-post e campos personalizados, possibilitando o rastreamento preciso de transações de afiliados mesmo ao usar scripts personalizados para entrega digital ou registro de membros.

Como configuro o plugin Setcom no Post Affiliate Pro?

Ative o plugin Setcom em PAP > Menu inicial > Plugins e configure com seu nome de usuário, senha e identificador de comerciante do painel Setcom. Defina o separador (padrão é ||) e salve suas configurações.

Quais passos são necessários para atualizar os botões de pagamento Setcom para integração?

Adicione um campo de input oculto chamado 'MerchCustom' a cada formulário de botão Setcom e insira o script de rastreamento do Post Affiliate Pro após o formulário para garantir o rastreamento correto dos afiliados.

Como posso encaminhar o callback Auto-post para o Post Affiliate Pro a partir do meu script?

No seu script de processamento Setcom, use cURL para encaminhar os dados de callback POST para o endpoint do plugin Setcom do Post Affiliate Pro, garantindo que tanto seu processo original quanto o rastreamento de afiliados funcionem perfeitamente.

Qual o formato do parâmetro personalizado utilizado nesta integração?

O parâmetro personalizado é formatado como 3rdPartySystemValue||PapValue. Faça o parsing do valor conforme necessário no seu script para separar seu valor original do valor de rastreamento de afiliados.

Lucia é uma talentosa editora de conteúdo que garante a publicação perfeita de conteúdos em várias plataformas.

Lucia Halašková
Lucia Halašková
Editora de Conteúdo

Experimente o Post Affiliate Pro gratuitamente

Tenha uma integração perfeita com Setcom e poderosos recursos de rastreamento de afiliados. Comece já seu teste gratuito do Post Affiliate Pro.

Learn more

Setcom (Auto-post usado por outro script)
Setcom (Auto-post usado por outro script)

Setcom (Auto-post usado por outro script)

Saiba como integrar o Setcom utilizando callbacks Auto-post com o Post Affiliate Pro. Este guia cobre ativação do plugin, configurações, atualização dos botões ...

2 min read
Payments Integration +3
Setcom
Setcom

Setcom

Gostaria de aprimorar ainda mais seu software de afiliados? Confira a integração Setcom para o Post Affiliate Pro.

5 min read
Setcom AffiliateIntegration +3
SimpleShop (.com)
SimpleShop (.com)

SimpleShop (.com)

Integre o SimpleShop com o Post Affiliate Pro para rastrear e aprovar automaticamente comissões de vendas. Aprenda a configurar os códigos de rastreamento de ve...

5 min read
Integration E-commerce +4

Você estará em boas mãos!

Junte-se à nossa comunidade de clientes satisfeitos e forneça excelente suporte ao cliente com o Post Affiliate Pro.

Capterra
G2 Crowd
GetApp
Post Affiliate Pro Dashboard - Campaign Manager Interface