Skip to main content
Produtos são itens do seu catálogo usados nas cobranças: nome, preço, descrição e opcionalmente ciclo de assinatura. Avulso = pagamento único (cycle omitido ou null). Assinatura = cycle: WEEKLY, MONTHLY, QUARTERLY, SEMIANNUALLY ou ANNUALLY. Produtos também podem ter um arquivo para download vinculado: um PDF que o comprador recebe acesso após o pagamento (e-books, ingressos, licenças, etc.).

Criar produto

Use /products/create. Moeda é sempre BRL.

Campos obrigatórios

Obrigatórios: externalId (único no seu sistema), name, price, currency. Opcionais: description, imageUrl, fileUrl, cycle (null/omitido = avulso), trialDays (requer cycle).
Exemplo (produto avulso):
Exemplo (produto de assinatura):
Exemplo (produto de assinatura com período de teste gratuito):
Resposta (modelo Product):
O data retornado segue o modelo Product: id, externalId, name, description, imageUrl, hasFile, price, currency, status, cycle, trialDays, createdAt, updatedAt, etc.

Arquivo para download

Vincule um PDF ao produto passando fileUrl na criação. A AbacatePay baixa e armazena o arquivo internamente — o link original não é exposto.
  • fileUrl aceita qualquer URL pública de PDF. Tamanho máximo: 20 MB.
  • Após o pagamento, o comprador recebe acesso ao download automaticamente.
  • O campo hasFile na resposta indica se o produto possui arquivo vinculado (true / false).
Exemplo (produto com arquivo):
Resposta:
O URL do arquivo nunca é exposto pela API. Use hasFile para verificar se o produto tem um arquivo vinculado.