Produtos, preços e ofertas

​

Modelo

• Produto: nome, descrição, referência externa, imagens.
• Preço: amountMinor em centavos + moeda. Criar um novo preço cria uma versão; o histórico permanece.
• Oferta: produto + preço vigente + métodos de pagamento (PIX, CARD), maxInstallments e cadência (avulsa ou recorrente). Publicar a oferta gera o publicCode do link de pagamento.

​

Regras de estado

• Só ofertas publicadas geram vendas. Arquivar uma oferta não cancela sessões de checkout já abertas (elas completam dentro do TTL).
• POST /v1/offers/{id}/revisions cria uma revisão da oferta; publish troca a versão ativa.
• Um produto arquivado não aceita novas ofertas.

​

Imagens

# 1. Solicita um upload (pré-assinado, com checksum)
curl -X POST https://api.korbit.com.br/v1/products/{id}/image-uploads \
  -H "Authorization: Bearer kbt_live_EXEMPLO_NAO_USAR" ...

# 2. Envia o arquivo direto ao storage com o body exato do presigned PUT

# 3. Confirma: a Korbit valida o objeto armazenado (tipo, tamanho, checksum)
curl -X POST https://api.korbit.com.br/v1/products/{id}/image-uploads/{uploadId}/complete \
  -H "Authorization: Bearer kbt_live_EXEMPLO_NAO_USAR"