> ## 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.

# PATCH /api/v1/checkout-links/:id

> Atualiza um link de checkout existente

Atualiza os campos de um link de checkout. Apenas os campos enviados serão atualizados.

## Autenticação

Requer **Organization Access Token (OAT)** via header `Authorization: Bearer`.

## Parâmetros de Path

**id** `string` *required*

ID único do checkout link

## Corpo da Requisição

Todos os campos são opcionais. Apenas os campos enviados serão atualizados.

**success\_url** `string`

URL de redirecionamento após pagamento bem-sucedido.

**cancel\_url** `string`

URL de redirecionamento quando o comprador abandona ou cancela o checkout. Envie `null` para remover.

**label** `string`

Nome identificador do link (visível apenas para a organização).

**products** `array`

Lista de IDs de produtos a associar ao link. Substitui a lista atual.

**allow\_discount\_codes** `boolean`

Permite que o comprador insira cupons de desconto no checkout.

**discount\_id** `string`

ID do desconto a aplicar automaticamente. Envie `null` para remover.

**require\_billing\_address** `boolean`

Quando `true`, torna o endereço de cobrança obrigatório durante o checkout.

**no\_fees\_installments** `boolean`

Quando `true`, as parcelas são oferecidas sem juros ao comprador.

**custom\_price\_amount** `number`

Valor personalizado em centavos. Substitui o preço padrão do produto. Envie `null` para restaurar o preço original.

**payment\_processor** `string`

Identificador do processador de pagamento (valor conforme contrato da API no ambiente).

**metadata** `object`

Metadados personalizados em formato chave-valor.

## Exemplo

```bash cURL theme={null}
curl -X PATCH https://api.chargefy.io/api/v1/checkout-links/clink_def456 \
  -H "Authorization: Bearer $CHARGEFY_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Link Plano Pro - Atualizado",
    "success_url": "https://meusite.com/nova-pagina"
  }'
```

```typescript SDK theme={null}
import { Chargefy } from '@chargefy/sdk';

const chargefy = new Chargefy({
  accessToken: process.env.CHARGEFY_ACCESS_TOKEN,
});

const link = await chargefy.checkoutLinks.update('clink_def456', {
  label: 'Link Plano Pro - Atualizado',
  successUrl: 'https://meusite.com/nova-pagina',
});
```

## Resposta de Exemplo

```json theme={null}
{
  "id": "clink_def456",
  "label": "Link Plano Pro - Atualizado",
  "url": "https://pay.chargefy.io/clink_def456",
  "product_ids": ["prod_123"],
  "discount_id": "disc_abc",
  "success_url": "https://meusite.com/nova-pagina",
  "metadata": {
    "source": "email-marketing"
  },
  "allow_discount_codes": true,
  "created_at": "2026-03-12T10:00:00Z",
  "updated_at": "2026-03-12T11:00:00Z"
}
```


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