# Atualizar link de pagamento
`PUT /v1/checkouts/:id`
**Área:** Links de pagamento

**Scopes necessários:** `checkouts/write`

Atualiza as configurações de uma página de pagamento, como preço vinculado, parcelamento ou aparência. Todos os campos são opcionais — envie apenas o que deseja alterar.

### Path parameters

| Campo | Obrigatório | Descrição |
|---|---|---|
| `id` | **sim** | ID do checkout / payment link (ex: pl_xxx) - required |

### Request body

```json
{
  "priceId": "price_yyy",
  "discounts": [],
  "maxInstallments": 6,
  "primaryColor": "#FF0000",
  "showProductImage": false,
  "termsOfServiceUrl": "https://meusite.com/termos-de-servico",
  "privacyPolicyUrl": "https://meusite.com/politica-de-privacidade",
  "applyBrandingToAllPrices": true
}
```

### Campos do body

**Opcionais**

| Campo | Descrição |
|---|---|
| `priceId` | Novo preço vinculado ao checkout |
| `maxInstallments` | Limite de parcelas (1 a 12) |
| `primaryColor` | Cor primária em hex |
| `showProductImage` | Exibir imagem do produto |
| `termsOfServiceUrl` | Termos de serviço exibidos no checkout para aceite do cliente |
| `privacyPolicyUrl` | Política de privacidade exibida no checkout para aceite do cliente |
| `applyBrandingToAllPrices` | Aplica a identidade visual a todos os preços |

### Resposta 200 — 200

```json
{
  "id": "pl_xxx",
  "priceId": "price_yyy"
}
```

### Resposta 404 — 404

```json
{
    "error": {
        "message": "Checkout não encontrado",
        "code": "CHECKOUT_NOT_FOUND",
        "details": null,
        "timestamp": "2026-07-14T21:39:36.322Z"
    }
}
```

---
Página: https://docs.validapay.com.br/documentacao-validapay2/put-atualizar-link-de-pagamento
Contrato OpenAPI: https://docs.validapay.com.br/openapi.json