API

A API da Rivoo é REST com JSON. Tudo o que o painel faz com a loja (pedidos, catálogo, clientes, entregas, cupons) dá para fazer por ela.

• URL base: https://api.rivoo.gg
• Autenticação: Authorization: Bearer <chave de API> (como criar a chave)
• Formato: JSON em UTF-8. Dinheiro em centavos de real (2990 = R$ 29,90), datas em ISO 8601 (UTC).
• IDs: texto com prefixo do tipo (ord_, prod_, cus_…), sempre em ordem de criação.

Primeiro pedidoCopiar link

curl -X POST "https://api.rivoo.gg/v1/orders" \
  -H "Authorization: Bearer $RIVOO_API_KEY" \
  -H "Idempotency-Key: pedido_123" \
  -H "Content-Type: application/json" \
  -d '{ "items": [{ "productId": "prod_...", "quantity": 1 }], "externalId": "pedido_123" }'

A resposta traz o pedido e um checkoutUrl: mande o comprador para lá. Quando ele pagar, chega o webhook order.paid.