O que mudou

Criar um produto pela API agora é idempotente. Ao chamar POST /api/v1/products com o header X-Idempotency-Key, uma segunda chamada com a mesma chave — por causa de um retry, um timeout de rede ou um duplo clique — devolve exatamente o mesmo produto que a primeira criou, em vez de criar um duplicado.

A chave vale por 24 horas e é isolada por conta (a mesma chave em vendedores diferentes não colide). Cobranças, pedidos e checkout-sessions já eram idempotentes — a criação de produtos era a última peça que faltava para fechar essa garantia em toda a API.

O SDK oficial @garuhq/node já envia um X-Idempotency-Key automaticamente em toda criação de produto, então quem usa o SDK ganha isso sem mexer em nada.

Precisa fazer algo?

Nada obrigatório. Se você integra direto pela API (sem o SDK), passe um X-Idempotency-Key único por produto que quiser criar — assim um retry deixa de correr o risco de gerar produtos duplicados. Quem usa o SDK já está coberto.