> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clipping.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Coleções pagas

> Cobre por acesso a uma coleção e deixe fãs assinarem.

Uma coleção pode ser **paga**: o dono (creator) define um preço, e fãs pagam pra
liberar o conteúdo. O pagamento vai pros earnings do creator, menos a taxa de
plataforma.

## Defina um preço (creator)

A coleção precisa ser **pública**, aí defina `price_coins` e um `billing_period`:

```bash theme={null}
curl -X PATCH https://api.clipping.cc/v1/collections/col_123 \
  -H "Authorization: Bearer ck_live_…" -H "Content-Type: application/json" \
  -d '{ "visibility": "public", "price_coins": 20, "billing_period": "monthly" }'
```

| `billing_period` | Acesso                                      |
| ---------------- | ------------------------------------------- |
| `once`           | vitalício — paga uma vez, mantém o acesso   |
| `monthly`        | renova a cada 30 dias (cobrança automática) |

`price_coins: 0` deixa grátis de novo (uma coleção pública volta ao normal, gated
só pelas flags `expose_*` de [Coleções](/pt/guides/collections)).

## Assine (fã)

Um fã assina — isso **cobra o preço na hora** e libera o acesso:

```bash theme={null}
curl -X POST https://api.clipping.cc/v1/collections/col_123/subscribe \
  -H "Authorization: Bearer ck_live_…"
```

```json theme={null}
{ "subscription": { "subscription_id": "sub_…", "status": "active",
                    "billing_period": "monthly", "price_coins": 20,
                    "expires_at": 1719500000 } }
```

Erros possíveis:

| Status | Quando                                              |
| ------ | --------------------------------------------------- |
| `400`  | coleção não é paga, não é pública, ou você é o dono |
| `402`  | saldo insuficiente pra pagar o preço                |
| `409`  | você já assina                                      |

## Veja suas assinaturas

```bash theme={null}
curl https://api.clipping.cc/v1/collections/subscriptions \
  -H "Authorization: Bearer ck_live_…"
```

Numa assinatura `once` o `expires_at` é null (vitalícia); numa `monthly` é a data
de renovação. Acesso ao conteúdo gated é: **dono, ou coleção grátis, ou uma
assinatura ativa.**