1. API de pagamentos
A integração por API permite criar cobranças Pix e consultar pagamentos. As permissões da credencial determinam quais operações ela pode executar.
Seu desenvolvedor faz as chamadas pelo servidor, guarda o identificador da cobrança junto ao pedido e apresenta o Pix retornado ao comprador. A credencial secreta não deve ser colocada no código público do checkout.
2. Notificações para o seu servidor
Cadastre o endereço HTTPS que receberá os eventos e selecione os eventos necessários à integração. O painel permite acompanhar as tentativas de entrega.
O receptor precisa aceitar o formato enviado e tratar eventos repetidos. Uma falha de entrega da notificação não comprova que o pagamento falhou; consulte a transação antes de tomar uma decisão.
3. Rastreamento com UTMify
A ClownPay possui configuração de UTMify no painel de integrações. O envio depende da ativação e das credenciais informadas na sua conta.
Para relacionar a venda à campanha, o checkout deve preservar os parâmetros de origem e enviá-los nos metadados da cobrança. Sem esses dados, uma integração de rastreamento não consegue reconstruir a campanha que trouxe o comprador.
4. Outras plataformas e checkouts
Uma plataforma externa pode se conectar usando a API e os webhooks da ClownPay. Isso exige implementação ou compatibilidade do lado dessa plataforma.
Antes de anunciar uma conexão como pronta, confirme o mapeamento dos campos, o vínculo com a conta e o recebimento dos eventos necessários. A existência de uma API não significa que todo checkout já esteja integrado.