Referência da API
Deletar produto
Arquiva o produto: marca `deletedAt` e seta `active: false`. **Bloqueia se houver QUALQUER Offer vinculada ainda não arquivada**, mesmo que a Offer esteja inativa. A ideia é forçar você a arquivar as Offers primeiro (que por sua vez podem bloquear se tiverem assinaturas ativas) — evita perda silenciosa de dados. Idempotente: arquivar um produto já arquivado retorna `{ success: true, alreadyDeleted: true }`.
DELETE
/v2/products/:idCascade manual
id Você precisa arquivar Offers antes do Product. Se quer simplesmente parar de vender, use PATCH com `active: false` em vez de DELETE — mantém histórico intacto.Autenticação
HTTP Basic Auth. Envie sua secret key no header:
Authorization: Basic {base64(secret:SUA_SECRET_KEY)}Parâmetros
idstring (path, UUID)obrigatórioUUID do produto.
Exemplo: prd_111aaa-bbb-ccc
Respostas
200
Produto deletado (ou já estava deletado).
JSON
{ "success": true }400
Produto tem Offers vinculadas. A mensagem diz quantas.
JSON
{
"status": 400,
"error": "Produto \"Curso de Marketing Digital\" tem 3 oferta(s) vinculada(s). Exclua as ofertas antes."
}404
Produto não encontrado.
JSON
{ "status": 404, "error": "Produto nao encontrado" }Exemplos
cURL
curl -X DELETE "https://api.pagnovo.com/v2/products/prd_111aaa-bbb-ccc" \
-H "Authorization: Basic $(echo -n 'secret:SUA_SECRET_KEY' | base64)"