Solucao de Problemas

Checklist passo-a-passo para problemas comuns. Comece do topo - maioria e pega nos tres primeiros checks.

"Esta pagina nao esta aberta"

Widget desativado. Dashboard > Bookings > Widgets > {widget} > Ativado = sim.

"Nenhum modelo disponivel"

Subaccount sem modelo com faixa de preco publicada.

1. Dashboard > Veiculos > Modelos - precisa de pelo menos um.
2. Dashboard > Precos - modelo precisa de faixa publicada.
3. Widget Faixa padrao aponta para faixa real.

Widget incorporado nao aparece

Em ordem de probabilidade:

1. Tag <script> com data-slug errado ou typo. Conferir source.
2. Elemento data-target nao existe. Precisa estar no DOM quando script roda.
3. CSP bloqueia iframe. Console mostra "Refused to frame". Adicionar frame-src widget.levyelectric.com.
4. Script em bloco de texto, nao codigo. Squarespace/Wix removem <script> de texto.

Erros CORS na reserva

"Origin not allowed" ou "Blocked by CORS policy" no Pay:

1. Dashboard > Bookings > Widgets > {widget} > Origens permitidas.
2. Origem exata listada:
   • https://www.frankebikes.com NAO casa com https://frankebikes.com.
   • https://frankebikes.com NAO casa com http://frankebikes.com.
3. Listar ambos https:// e https://www. se site redireciona.

GETs sao CORS-abertos. So POSTs precisam da lista.

Botao Apple Pay nao aparece

Apple Pay so com:

1. Cliente em Safari com Apple Pay configurado.
2. Cartao em Apple Wallet.
3. Widget Apple Pay ligado.
4. HTTPS.

"Cartao recusado" no teste

Cartao de teste 4242 4242 4242 4242 so funciona em chave test. Seu widget usa live (correto em prod). Teste: cartao real + reembolso imediato, ou subaccount em demo (admin Levy alterna).

Termo nao salva / assinatura em branco

Tres causas:

1. Desenhou com mouse em touchscreen. Use dedo ou stylus.
2. Privacidade agressiva. Brave/Firefox-Resist-Fingerprinting pode quebrar canvas.
3. Limpou no meio do desenho.

Se desenha mas nao salva: aba rede, status 4xx em /api/widget/{slug}/bookings/{id}/sign. Token na URL expirou (24h). Cliente comeca novo.

Stripe Terminal nao conecta

BBPOS WisePOS E:

1. Mesma Wi-Fi.
2. Reiniciar leitor (segurar 5s).
3. PDV Esquecer leitor, redescobrir.

Tap to Pay em iPhone:

1. iOS 16.4+.
2. EUA/Reino Unido/Canada.
3. iCloud logado.
4. Aceitar termos.

PIN PDV expirou

PINs valem 10 min. Gerar novo em Dashboard > Bookings > PDV.

Confirmacao por email nao chegou

1. Spam / promocoes.
2. Conferir email.
3. Dashboard > Reservas > {reserva} log de email. "delivered" = enviado, servidor filtra.
4. "bounced" = invalido.

Reenviar com Reenviar confirmacao.

SMS nao chegou

1. Numero com codigo do pais.
2. Dashboard > Config > SMS - sem Twilio = sem SMS.
3. Carriers podem filtrar - dica whitelist.

Codigo promo rejeitado

Endpoint diz "nao valido" para:

• Codigo nao existe.
• Desativado.
• Fora de janela.
• max_redemptions atingido.
• applies_to nao cobre.
• Min quantidade nao atendida.

Abrir codigo no dashboard para ver causa real.

"Esgotado" mas tenho veiculos

Engine respeita model_inventory_caps.

1. Dashboard > Car Sharing > Reservas > Inventario.
2. Achar cap para modelo + local + janela.
3. Aumentar / remover.

Tambem checar reservas sobrepostas de outros canais.

Cliente diz que pagou mas sem confirmacao

Dashboard > Reservas buscar por email/telefone. Comum: fechou navegador apos pagamento antes do render.

Reserva existe, cartao cobrado. Reenviar confirmacao.

Se reserva NAO existe mas Stripe mostra cobranca: ticket com charge ID.

Webhooks nao disparam

Levy Bookings emite booking.created, booking.confirmed, booking.cancelled, booking.refunded. URLs em Dashboard > Config > Webhooks.

1. Endpoint responde 2xx.
2. Log de webhooks.
3. 5xx: retries com backoff ate 24h.

Reserva ok, desbloqueio IoT falha

Nao e Bookings - reserva ok, IoT falhou. Veja Solucao IoT.

Comum: IoT do veiculo offline. Dashboard > Veiculos status.

Guias relacionados

• Incorporar o Widget
• Configurar iPad PDV
• FAQ