Integração com xTracky
Como funciona a integração com a xTracky?
A integração com a xTracky (plataforma de rastreamento de vendas) não exige desenvolvimento do lado da CN Pay.
A CN Pay já disponibiliza o modelo padrão de eventos via webhook.
A integração é realizada do lado da xTracky, que já possui compatibilidade com gateways white label baseados na CN Pay.
Por que a xTracky pede para adicionar um webhook?
A xTracky precisa receber eventos da sua plataforma para registrar:
Venda criada
Pagamento aprovado
Atualização de status
Esses eventos são enviados automaticamente por meio de webhooks configurados no painel do produtor.
O que o você precisa informar ao suporte da xTracky
Ao entrar em contato com a xTracky, você deve informar que:
Utiliza um gateway white label da CN Pay
A plataforma já possui modelo padrão de webhook
Basta configurar a URL de recebimento no painel
A xTracky já possui o modelo de integração preparado para esse padrão.
Como configurar o webhook na plataforma
Para concluir a integração, o produtor deve:
Acessar o painel da conta de produtor
Ir até a área de Webhooks
Adicionar um novo webhook
Informar a URL fornecida pela xTracky
Exemplo de URL enviada por eles:
https://xapi.xtracky.com/api/integrations/pre/123-456
Salvar a configuração
Após isso, os eventos de pagamento começarão a ser enviados automaticamente.
Sobre os eventos solicitados
A xTracky geralmente solicita dois eventos:
waiting_payment
paid
Esses status já fazem parte do fluxo padrão da CN Pay e são enviados conforme a atualização da transação.
Os dados como:
orderId
amount
status
utm_source
São enviados dentro da estrutura padrão de webhook da plataforma.
Caso a xTracky precise mapear campos específicos, o ajuste é feito do lado deles, interpretando o payload recebido.
Importante
Não é necessário desenvolvimento interno
Não é necessário criar endpoint personalizado
Não é necessário alterar API
A única ação necessária é configurar corretamente o webhook no painel do produtor.
Resumo
A integração com a xTracky:
É feita via webhook
Não exige alteração técnica na CN Pay
Deve ser configurada no painel do produtor
A lógica de leitura dos eventos é responsabilidade da xTracky
Se houver dúvidas específicas sobre mapeamento de campos, o cliente deve tratar diretamente com o suporte da xTracky.