Onde encontro o ID do produto
O código que apps e áreas de membros externas pedem pra conectar ao seu produto.
Onde ficaProdutosseu produto
Alguns apps pedem o ID do produto pra saber qual venda liberar. É o caso de áreas de membros externas, ferramentas de automação e integrações por webhook.
Onde encontrar
- Abra Produtos e clique no produto
- Olhe o endereço no navegador:
app.pearfy.com.br/produtos/id/K7M3Q9 - O ID é o código depois de
id/. Nesse exemplo, K7M3Q9
O ID tem sempre 6 caracteres, só letras maiúsculas e números. Não tem 0, O, 1, I nem L, pra ninguém confundir na hora de copiar.
ID do produto não é ID da oferta
Cada oferta também tem um ID próprio. Os apps pedem o do produto, porque é ele que chega em toda venda, qualquer que seja a oferta comprada.
Onde o ID aparece nas integrações
| Onde | Campo |
|---|---|
| Webhooks | product.id em cada evento |
| API | id em GET /v1/products e product.id nas vendas |
Quando o campo pede o ID da outra ferramenta
Na aba Apps, a Cademi e a Astron Members também têm um campo ID do produto. Ali o ID é o do produto na ferramenta, não o da Pearfy. O produto da Pearfy você escolhe no campo Produto da mesma tela.
DicaO ID nunca muda. Pode renomear o produto ou mexer em preço e ofertas que a integração continua funcionando.
Perguntas frequentes
O app diz que o ID é inválido.
Confira se copiou os 6 caracteres depois de id/ no endereço do produto, e não o código de uma oferta ou do link de checkout.
Minha integração antiga usa um ID longo, com hífens.
A API continua aceitando o ID longo, e ele segue chegando nos webhooks no campo product.uuid. Se o app compara pelo ID do produto, troque o cadastro pelo ID curto.
Posso usar o link de checkout no lugar do ID?
Não. O app precisa do ID, que é o mesmo que chega nos webhooks e na API.
Cada produto tem um ID diferente?
Sim. Se o app vai liberar mais de um produto, cadastre o ID de cada um.
Este artigo foi útil?