Coleções pagas

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:

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

Assine (fã)

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

curl -X POST https://api.clipping.cc/v1/collections/col_123/subscribe \
  -H "Authorization: Bearer ck_live_…"

{ "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

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.

Começando

Conceitos

Guias

Defina um preço (creator)

Assine (fã)

Veja suas assinaturas

​Defina um preço (creator)

​Assine (fã)

​Veja suas assinaturas

Defina um preço (creator)

Assine (fã)

Veja suas assinaturas