Definir a entrega antes de montar o componente
Este roteiro atende lojistas e desenvolvedores que revisam um componente auto-hospedado, não um serviço gerenciado de premiação. Registrar responsável, datas, elegibilidade, resgate e origem do resultado. Roleta, raspadinha e caixas são formas de apresentação; animação não comprova distribuição. O modo local deve permanecer identificado como demonstração. O servidor da loja responde por autenticação, probabilidades, estoque e resgate reais.
Preservar uma exportação completa. Hospedar index.html, widget.css e widget.js juntos ou escolher conscientemente o HTML de arquivo único. config.json é uma fonte editável, não um cofre. Ofertas no código podem ser lidas por visitantes; imagens externas geram requisições dos navegadores deles. Usar exemplos fictícios ou sem dados sensíveis nas ferramentas auxiliares, nunca chaves, dados de clientes ou códigos reais.
Conciliar configuração e contrato de resposta
Construir o JSON Schema a partir da documentação da exportação atual. Conferir version, campaignId, mode, endpoint e identificadores de prêmio. Verificar separadamente IDs únicos e total local exato de 100%; uma validação estrutural básica não comprova essas relações. Setores iguais da roleta são visuais, não probabilidades iguais. Explicar mudanças de regras, textos e origem do resultado na comparação JSON. Após aprovação, exportar novamente sem misturar configuração nova e scripts antigos.
A requisição contém version, campaignId e requestId. A resposta deve devolver o mesmo requestId e um prizeId configurado; campos opcionais seguem o contrato exportado. Validar exemplos de prêmio e de ausência de prêmio e manter exemplos inválidos para testes negativos. Um esquema não executa a API nem verifica elegibilidade ou baixa de estoque. A prévia do editor nunca chama o endereço do lojista.
Revisar a leitura e a interação em todos os estados
Medir os pares reais de texto e fundo, incluindo botões e mensagens finais. Um par aprovado não equivale a uma auditoria completa de acessibilidade. Inspecionar HTML e confirmar no navegador rótulos, teclado, foco visível, percepção dos resultados e uso sem animação. Uma análise estática não certifica o gesto de raspar nem o quadro incorporado.
Testar traduções longas, letras ampliadas, imagens e links de resgate. Manter regras disponíveis em texto, não somente em animações. Não aprovar apenas a tela inicial; registrar problemas de interação mesmo que a prévia pareça bem acabada.
Exercitar a hospedagem e a incorporação reais
Publicar no domínio HTTPS de testes autorizado. Comparações responsivas revelam possíveis cortes; capturas registram uma vista, não um sorteio. Elas podem não alcançar estados autenticados ou inspecionar quadros de outra origem. Registrar endereço, largura e revisão e abrir a loja real para verificar altura, rolagem, teclado e links externos.
Uma rota relativa da API é resolvida na origem do componente, não na loja que o incorpora. O código envia credenciais apenas à mesma origem. Configurar CORS para um servidor externo não envia automaticamente cookies de sessão; bloqueios de cookies de terceiros também podem impedir autenticação no quadro. Usar uma origem dedicada sob seu controle e revisar as permissões do quadro: elas permitem integração, mas não garantem isolamento do código do lojista.
Testar prêmio, resultado sem prêmio configurado, HTTP sem sucesso, JSON inválido, prizeId desconhecido, requestId divergente e demora superior aos 15 segundos documentados. Falha não pode conceder um prêmio local substituto. Uma nova tentativa manual reutiliza a requisição pendente apenas nesta página; recarregar não fica protegido. O servidor deve persistir resultados idempotentes de modo transacional e tratar a resposta perdida depois da distribuição. Usar resultados de teste sem consumir prêmios reais.
Entregar uma revisão identificável
Calcular SHA-256 após a última alteração. Entregar arquivos, diferenças, domínio, contrato, evidências sem dados sensíveis, pendências e responsáveis. Hash identifica bytes, não justiça do sorteio ou correção do servidor. Estoque, elegibilidade, resgate e autorização da campanha são condições de lançamento separadas.
Para rastreamento e QR, seguir a revisão de links de campanha; para evidências antes/depois, a revisão responsiva; para arquivos candidatos de descontos, a pré-verificação de lotes Stripe. Nenhum substitui a aceitação desta integração.