VEIL Prize Network Docs Hub

  1. POST /veil-prize-network/merchants/issue cadastra o comerciante e entrega 600 cupons da adesão.
  2. POST /veil-prize-network/merchants/recharge recarrega créditos em PIX, de R$ 50 a R$ 1500.
  3. POST /veil-prize-network/merchants/{merchant_id}/entry-sessions abre a jornada oficial do participante com QR + HVC-16 + token do lojista.
  4. GET /veil-prize-network/entries/{entry_id}/state expõe o estado JSON da jornada, pronto para integração profissional.
  5. GET /veil-prize-network/merchants/{merchant_id}/entry-sessions/{entry_id}/state expõe o mesmo estado pela visão operacional do lojista.
  6. POST /veil-prize-network/coupons/issue emite cupons só depois da jornada humana e do token da loja.
  7. POST /veil-prize-network/cities/{city_code}/draw executa sorteio municipal auditável com 8 prêmios.
  8. GET /veil-prize-network/cities/{city_code}/urn expõe a urna digital imutável da cidade.
  9. GET /veil-prize-network/merchants/{merchant_id}/portal abre o perfil operacional do lojista.

Contrato profissional da jornada

  • Etapa 1: o participante entra por QR público e conclui a sessão oficial do HVC-16.
  • Etapa 2: a prova humana final confirma a presença legítima na mesma jornada.
  • Etapa 3: o cupom só é emitido após o token do lojista e os dados auditáveis do participante.
  • Pagamento: a chave PIX é preferencial; se estiver inválida ou desativada, o prêmio segue por auditoria para conta da mesma titularidade.