Docs
APIReferênciaPreços

Criar preço

Adiciona um preço ao produto, em centavos, avulso ou recorrente.

Permissão da chave: Catálogo › escrever.

Autenticação

bearer
headerAuthorizationBearer <chave de API>

Chave de API da loja (Painel › Integrações › Chaves de API)

Parâmetros do caminho

productId*string

Headers

Idempotency-Key?string

Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar.

Padrão (regex)^[A-Za-z0-9._:-]+$
Tamanho8 <= length <= 255

Corpo da requisição

application/json
  1. body
type*string
Valor em"ONE_TIME""RECURRING"
amount*
compareAt?
interval?string
Valor em"YEAR""WEEK""DAY""MONTH"
intervalCount?number
Intervalo1 <= value <= 12
makeDefault?boolean

Corpo da resposta

Exemplo de requisição
curl -X POST "https://api.rivoo.gg/v1/products/prod_mhexample0000vip00001/prices" \  -H "Authorization: Bearer $RIVOO_API_KEY" \  -H "Idempotency-Key: pedido_123" \  -H "Content-Type: application/json" \  -d '{"type":"ONE_TIME","amount":{"amount":0}}'
Exemplo de resposta
Vazio

Alterar preço PATCH

Altera ou desativa um preço. Assinaturas existentes mantêm o valor contratado. **Permissão da chave:** Catálogo › escrever.

Listar preços GET

Preços do produto: avulso e de assinatura (mensal, trimestral…). **Permissão da chave:** Catálogo › ler.