> ## Documentation Index > Fetch the complete documentation index at: https://userepass.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Registra um clique via snippet JS (público) > Rota pública (não requer autenticação). Registra um clique enviado pelo snippet JS a partir do token do link. Responde 201 com o clique rastreado ou 200 quando o rastreamento é pulado (afiliado pendente ou programa arquivado). Links removidos respondem 410. Emite o evento de webhook `click.recorded` quando rastreado. ## OpenAPI ````yaml /openapi.json post /track/click openapi: 3.1.0 info: title: Repass API description: >- API pública do Repass — plataforma de gestão de afiliados: programas, links, tracking, atribuição, conversões, comissões, payouts, fiscal (BR), reprocessamento, event store e webhooks. version: 0.1.0 servers: - url: https://api.userepass.com description: Produção security: - bearerAuth: [] - apiKeyAuth: [] tags: - name: Profile description: Perfil do usuário autenticado. - name: Guide description: >- Guia de onboarding do painel: estado de tours, telas visitadas e preferências por usuário e organização. - name: Portal description: >- Portal do afiliado: sessão por identidade de afiliado (sem org), convites e claim. - name: Programs description: 'Programas de afiliados: configuração, atribuição, hold e tiers.' - name: Commission Rules description: Regras de comissão versionadas (imutáveis) por programa. - name: Affiliates description: 'Ciclo de vida do afiliado: cadastro, aprovação, tier, saldo.' - name: Terms description: Termos do programa, versionados. - name: Materials description: >- Materiais (criativos) do programa: upload pelo gestor e download pelos afiliados. - name: Links description: Links rastreáveis e domínios de redirecionamento. - name: Coupons description: Cupons de afiliado e sync com gateway. - name: Pagamentos por PIX description: Habilitação de pagamentos por PIX (onboarding e documentos). - name: Tracking description: Endpoints públicos de redirect e registro de cliques. - name: Clicks description: Consulta de cliques e estatísticas de link. - name: Conversions description: 'Conversões: ingestão S2S, atribuição, matching, fraude e auditoria.' - name: Commissions description: Comissões calculadas, holds, aprovação, void e clawback. - name: Payouts description: Ciclos de pagamento, prévia, execução e comprovantes. - name: Invoices description: Notas fiscais (PJ), envio e validação (BR). - name: Fraud description: Fila de revisão e decisões de fraude. - name: Reprocess description: Reprocessamento com dry-run obrigatório e relatório de impacto. - name: Events description: Histórico de eventos para auditoria e consulta. - name: Notifications description: >- Notificações ao operador (falhas de sincronização, payouts e afins) — registro in-app espelhado por e-mail aos owners/admins. - name: Webhooks description: Endpoints de webhook, entregas, retries e dead-letter. - name: Ingest description: Ingestão de eventos de cobrança (S2S e gateways). - name: Settings description: Configurações por organização (políticas e integrações). - name: Billing description: 'Plano e cobrança: contadores de uso da organização para o painel.' - name: Dashboard description: >- Métricas agregadas da operação (receita, top afiliados, conversões, comissões, novos afiliados) para a home e os relatórios do gestor. - name: Health description: Liveness do serviço. paths: /track/click: post: tags: - Tracking summary: Registra um clique via snippet JS (público) description: >- Rota pública (não requer autenticação). Registra um clique enviado pelo snippet JS a partir do token do link. Responde 201 com o clique rastreado ou 200 quando o rastreamento é pulado (afiliado pendente ou programa arquivado). Links removidos respondem 410. Emite o evento de webhook `click.recorded` quando rastreado. operationId: trackClick requestBody: required: true content: application/json: schema: type: object properties: token: description: >- Token público do link de afiliado que originou o clique. Identifica programa, afiliado e destino. example: rp_abc123 type: string pattern: ^[a-z0-9-]{3,50}$ sub: description: >- Sub-identificador livre (subId) repassado pelo afiliado para segmentar a origem do clique. Propagado para a conversão. example: campanha-natal type: string minLength: 1 maxLength: 120 referrer: description: URL de origem (referrer) da página onde o clique ocorreu. example: https://blog.exemplo.com/post type: string format: uri visitorId: description: >- Identificador do visitante já conhecido (cookie first-party). Se ausente, um novo visitante é criado. example: vis_01J9Z3K8YQ4N2T7B6F0X1A2C3D type: string pattern: ^vis_[0-9A-HJKMNP-TV-Z]{26}$ required: - token responses: '200': description: Default Response content: application/json: schema: type: object properties: tracked: type: boolean description: 'Sempre `false`: indica que o clique NÃO foi registrado.' enum: - false reason: type: string enum: - affiliate_pending - program_archived description: >- Motivo de não rastrear: `affiliate_pending` (afiliado ainda não aprovado) ou `program_archived` (programa arquivado). required: - tracked - reason additionalProperties: false '201': description: Default Response content: application/json: schema: type: object properties: tracked: type: boolean description: >- Sempre `true`: indica que o clique foi registrado com sucesso. enum: - true clickId: type: string description: >- Identificador do clique registrado, usado para atribuir uma conversão posterior a este clique (atribuição server-to-server). example: clk_01J9Z3K8YQ4N2T7B6F0X1A2C3D visitorId: type: string description: >- Identificador do visitante (cookie first-party) associado ao clique. example: vis_01J9Z3K8YQ4N2T7B6F0X1A2C3D expiresAt: description: >- Data de expiração da janela de atribuição do clique: após essa data o clique não pode mais ser creditado a uma conversão. example: '2026-07-13T12:00:00.000Z' type: string format: date-time required: - tracked - clickId - visitorId - expiresAt additionalProperties: false security: [] components: securitySchemes: bearerAuth: type: http scheme: bearer description: >- Chave de API (prefixo `rstr_`) enviada como `Authorization: Bearer rstr_...`. apiKeyAuth: type: apiKey in: header name: x-api-key description: Chave de API (prefixo `rstr_`) enviada no header `x-api-key`. ````