Email de suporte

Cada produto pode ter um email de suporte verificado que aparece no checkout, fatura e comunicações. Sem verificação, o email não é exibido.

Por quê

A Zhex permite que você liste qualquer email no produto, mas só emails verificados entram em comunicação com clientes. Razão: prevenir phishing — alguém criar produto com email genérico (suporte@gmail.com) e fingir representar a Zhex.

Verificar

Endpoint: POST /v1/products/:id/verify_support_email

curl -X POST https://prometheus.zhex.io/v1/products/prd_xyz/verify_support_email \
  -H "Authorization: Bearer $ZHEX_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{ "support_email": "suporte@meusite.com" }'

A Zhex envia um link de confirmação ao endereço. O dono do email clica → status do produto muda para support_email_verified: true.

Status

const res = await fetch(`https://prometheus.zhex.io/v1/products/${productId}`, {
  headers: { Authorization: `Bearer ${process.env.ZHEX_SECRET_KEY}` },
});
const product = await res.json();
console.log(product.support_email);            // "suporte@meusite.com"
console.log(product.support_email_verified);   // true | false

Apenas se support_email_verified === true o email aparece em:

• Hosted checkout (footer "Dúvidas? suporte@meusite.com")
• Fatura por email (assinatura)
• Email de cobrança falhada (link de suporte)
• Página pública do produto (se exibida)

Trocar email

Trocar support_email zera a verificação. Você precisa rodar verify_support_email no novo endereço.

import { randomUUID } from 'node:crypto';

await fetch(`https://prometheus.zhex.io/v1/products/${productId}`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.ZHEX_SECRET_KEY}`,
    'Idempotency-Key': randomUUID(),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ support_email: 'novo-suporte@meusite.com' }),
});
// support_email_verified vira false automaticamente

Boas práticas

• Use email do mesmo domínio do landingPage. suporte@meusite.com quando landingPage = https://meusite.com/produto. Domínios divergentes geram flag de risco.
• Não use Gmail/Hotmail/Yahoo em produção. A Zhex aceita verificar, mas marca o produto com risk_flag: GENERIC_EMAIL que pode atrasar payouts.
• Mailbox compartilhado > pessoal. suporte@ ou contato@ lê melhor que joao@meusite.com.
• Configure auto-resposta confirmando que o cliente atingiu o suporte. Reduz chargeback "service_not_received" em ~15%.