> ## Documentation Index
> Fetch the complete documentation index at: https://scaleup-c34c4386.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```bash cURL theme={null}
# 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"
```

> [!NOTE]
>
> 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.