GET /api/v1/checkout-links/:client_secret/redirect

Endpoint público que cria uma sessão de checkout e redireciona o visitante para a página de pagamento

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

Status	Descrição
302 Found	Redirecionamento bem-sucedido para a página de checkout
400 Bad Request	client_secret ausente
404 Not Found	Checkout link não encontrado
422 Unprocessable Entity	Link sem produtos ou produto sem preço disponível
500 Internal Server Error	Erro 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.