Quando uma reserva pré-paga falha: auto-reembolso e verdade de estado

Uma hold pré-paga incompleta deve deixar dinheiro e estado defensáveis pela finance. A falha não é teatro de «tente mais tarde». Ou a reserva regressa ao saldo disponível, ou um reembolso explícito inverte um montante liquidado, ou um estado terminal congela retries até haver evidência. Fundos presos com sucesso falso = ledger sem confiança.

A IOSOR é prepaid white-label. Mesma regra: messaging, verification, email, voice e intents JIT numa carteira. O mínimo USD 20 é o chão do piloto, não prova do fail path. Review perto de USD 1.000/mês só torna essas linhas visíveis.

A falha é um evento de carteira, não um toast

Após a falha: hold libertada, débito reembolsado ou intent congelado com razão exportável. Reserva aberta + sucesso = ledger mentiroso. Happy path: reserva pré-paga antes do primeiro débito; esta página é o fail path.

Auto-reembolso e libertação devem ser automáticos

«Ops corrige depois» não é produto. Release de hold não usada e refund de settle errado saem das mesmas regras da reserva. Duplicados com a mesma chave reutilizam o resultado monetário — idempotência, retries e dinheiro. Lotes parciais liquidam unidades feitas e devolvem o resto num export.

Vocabulário de estado que a finance pode exportar

Lista curta que sobreviva em CSV:

• funds held
• completed / settled
• released
• refunded
• needs attention
• cancelled

Não invente «Activated», «Delivered» ou «Live» sem recurso nem unidade faturável. «Needs attention» é fila de trabalho, não sucesso. Sem montante, moeda e correlation ID, é teatro.

Nunca falsifique Activated ou Delivered

Sucesso falso queima confiança mais depressa do que pesquisa vazia. Messaging falhado ≠ entregue. Verify sem sessão ≠ verificada. JIT sem assign ≠ Activated. Rejeições de saldo baixo e over-cap ocorrem antes da hold quando possível — paragens por saldo baixo — para o dinheiro não entrar numa reserva sem saída.

Checklist do comprador para honestidade da falha

1. Cada hold falhada termina em release, refund ou freeze needs-attention com dono?
2. Release e refund saem de eventos de produto, não de chat?
3. A finance junta falhas ao intent ID original sem suporte?
4. Retries com a mesma chave movem dinheiro no máximo uma vez?
5. Erros ao cliente brand-safe e sem marcas upstream?
6. Stop-lines bloqueiam novas holds com saldo baixo?

Comece com a IOSOR

Force um hold pré-pago que não consegue concluir: teto, rejeição ou falta. Prove o regresso a available ou uma linha de refund explícita. Exporte o estado de falha que as finanças defendem. Repita a mesma chave sem segundo movimento. É verdade de hold falhado, não uma libertação após assign morto.

Related: controlo de gasto prepaid

Conclusão IOSOR

Um hold falhado é um evento de carteira, não teatro de sucesso.

Faça: libertação ou refund automático e estado nomeado. Não faça: inventar Activated ou Delivered.