Codigos Promo e Caucao

Este guia cobre duas customizacoes muito usadas: codigos de desconto e caucoes reembolsaveis contra dano e roubo.

Codigos promo sao descontos por subaccount que clientes inserem no pagamento. Sistema valida, aplica desconto e incrementa contador atomicamente.

Criar codigo

Dashboard > Bookings > Codigos Promo.
Novo codigo.
Campos:

Campo	Exemplo
Codigo	VERAO25
Tipo	Percentual / Fixo / Add-on gratis
Valor	25 (para 25%)
Inicia em	2026-06-01
Termina em	2026-09-01
Max resgates	100
Aplica a	Todos / Modelos / Add-ons
Min quantidade	1
Ativo	sim

Tipos de desconto

Percentual. "VERAO25 = 25% off."
Fixo. "BIKE10 = 10 USD off."
Add-on gratis. "FREEHELMET = um capacete gratis."

Descontos fixos limitados a subtotal (sem total negativo). Percentual antes do imposto.

Como clientes usam

No pagamento, link Tem um codigo?. Cliente digita, preco atualiza ao vivo.

Codigo invalido / expirado / esgotado: "Codigo nao valido" sem detalhes (contra adivinhacao).

Prevencao de abuso

Endpoint rate-limited por IP e email. 5 tentativas invalidas -> cooldown.

Em vazamento: Ativo = nao. Reservas confirmadas mantem desconto, novas nao.

Relatorios

Por codigo: resgates, desconto dado, receita ligada, lista de reservas.

Caucoes reembolsaveis

Caucoes protegem contra dano e roubo. Sao retidas (nao cobradas) via pre-autorizacao Stripe e liberadas em devolucao limpa.

Quando usar

Usar:

Frota cara (1,500+ USD).
Historia de dano absorvido.
Clientes podem sair da cidade/pais.
Primeiros clientes nao verificados.

Pular:

Frota barata (sub 500 USD).
Locais regulares confiaveis.
Friccao mataria conversao.

Padroes de caucao

Dashboard > Bookings > Widgets > {widget}.
Padroes de caucao.
Definir:
- Valor (centavos) - ex 20000 para 200 USD.
- Janela de captura - quanto Stripe segura (padrao 7 dias, max 7).
- Liberar em devolucao limpa - sim padrao.

Override por modelo em Dashboard > Veiculos > Modelos > {modelo} > Caucao.

O que o cliente ve

Total do aluguel: 80,00 USD
Caucao reembolsavel: 200,00 USD (liberada em 7 dias)
Autorizado: 280,00 USD

Stripe captura 80 USD e pre-autoriza 200 USD. No extrato aparece pending 280 USD ate cair para 80.

Liberar caucao

No iPad PDV na devolucao: Liberar caucao. Pre-auth cancelada, hold some, deposit_status = released.

Tambem possivel no web dashboard.

Capturar caucao (dano)

Abrir reserva.
Capturar caucao > Total ou Parcial.
Valor (<= caucao).
Motivo + fotos.
Confirmar.

Stripe captura. Restante liberado. Captura e transacao deposit_capture separada - nao misturada com receita.

Liberacao automatica

Sem acao manual, Stripe libera apos janela de captura (padrao 7 dias). Mantenha hold curto - libere no mesmo dia em devolucao limpa.

Reembolsos com caucao

Cancelamento antes da retirada:

Aluguel reembolsado conforme politica.
Pre-auth de caucao liberada imediatamente.

Disputa apos captura: fluxo padrao Stripe.

Codigos aplicam so ao subtotal de aluguel - nao a caucao. 80 USD aluguel + 200 USD caucao + VERAO25 = 60 USD aluguel + 200 USD pre-auth.

Sempre reembolse via reserva

Regra mais importante: sempre reembolse via reserva, nunca direto na carteira.

Se cliente foi cobrado a mais:

Reembolsar no detalhe da reserva (web/iPad).
Ajustar tarifa para reducao de preco.

Nunca:

Atualizar customers.wallet_balance direto.
Inserir em wallet_transactions manual.
Chamar helpers de credito de carteira fora do fluxo de refund.

Reserva e fonte de verdade para receita liquida, impostos e repasses. Credito direto na carteira corrompe os tres.