Skip to main content
Endpoint público de redirecionamento para checkout links. Ao ser acessado, cria automaticamente uma sessão de checkout com base na configuração do link e redireciona o visitante para a página de pagamento. Parâmetros UTM e outros query params são repassados como metadados da sessão. Este endpoint segue o padrão do Polar e é protegido por rate limiting público — não requer autenticação.

​
Parâmetros de Caminho

​
client_secret
string
required
Segredo do checkout link. Disponível no campo client_secret do objeto retornado ao criar ou buscar um link.

​
Parâmetros de Query

​
embed_origin
string
Origem para checkout incorporado (embedded). Quando informado, é preservado na URL de redirecionamento e também adicionado à sessão de checkout.
​
reference_id
string
ID de referência externa. Adicionado aos metadados da sessão de checkout criada.
​
utm_source
string
Parâmetro UTM de origem da campanha. Adicionado aos metadados da sessão.
​
utm_medium
string
Parâmetro UTM de meio da campanha.
​
utm_term
string
Parâmetro UTM de termo da campanha.
​
utm_content
string
Parâmetro UTM de conteúdo da campanha.

​
Comportamento

  1. Busca o checkout link pelo client_secret
  2. Obtém o primeiro produto e seu preço disponível
  3. Cria uma nova sessão de checkout com os parâmetros do link (desconto, success_url, require_billing_address, no_fees_installments, preço customizado)
  4. Mescla os query params recebidos nos metadados da sessão
  5. Retorna 302 Found redirecionando para a URL do checkout
A resposta inclui os headers Cache-Control: no-store para evitar cache de redirecionamentos no browser e em CDNs.

​
Resposta

StatusDescrição
302 FoundRedirecionamento bem-sucedido para a página de checkout
400 Bad Requestclient_secret ausente
404 Not FoundCheckout link não encontrado
422 Unprocessable EntityLink sem produtos ou produto sem preço disponível
500 Internal Server ErrorErro ao criar a sessão de checkout

​
Exemplo

cURL
# Redirecionamento simples
curl -L "https://api.chargefy.io/api/v1/checkout-links/cs_live_abc123/redirect"

# Com parâmetros UTM e referência
curl -L "https://api.chargefy.io/api/v1/checkout-links/cs_live_abc123/redirect?utm_source=email&utm_medium=newsletter&reference_id=lead_789"
Use a URL do campo url retornado ao criar o checkout link — ela já aponta para este endpoint com o client_secret correto. Ideal para compartilhar em campanhas de marketing, emails e redes sociais.