Compra e financiamento do escrow
Contexto e Premissas (Importante)
Offer Hub modela um mercado clássico:
Vendedores listam bens ou serviços com antecedência
Compradores navegam pelas ofertas existentes
Um comprador cria um pedido clicando em Comprar
Cada pedido cria um escrow
Este fluxo pressupõe:
O vendedor e a oferta já existem
O comprador está iniciando a transação
Os fundos devem ser garantidos antes de a entrega começar
Objetivo
Criar um escrow por pedido e financiá-lo diretamente pelo comprador, mantendo a experiência simples e totalmente abstraída.
Da Perspectiva do Usuário
“Eu clico em Comprar. Se eu já tenho dinheiro, ele é reservado. Se não, eu pago da mesma forma que sempre. O vendedor só é pago se tudo for aprovado.”
O usuário nunca escolhe:
blockchains
carteiras
endereços de escrow
fluxos de assinatura
Atores
Comprador
Vendedor
Interface OfferHub
Backend OfferHub (Orquestrador)
Supabase (perfil do usuário + vínculo com Airtm)
Airtm (contas, saldos, rails)
Trustless Work (motor de escrow na Stellar)
Stellar (USDC)
Pré-condições
Comprador está logado (Supabase)
O comprador tem uma conta Airtm vinculada e aprovada em KYC
O vendedor tem uma oferta ativa
A plataforma está configurada como:
emissor de escrow
resolvedor de disputas
signatário de liberação
Fluxo em Alto Nível
Existem dois caminhos de financiamento voltados ao usuário, dependendo de o comprador já possuir fundos.
Caminho A — Comprador Tem Saldo Suficiente na Airtm (Caminho Primário)
Quando Isso Acontece
O comprador já possui USDC (ou equivalente) suficiente em sua conta Airtm
Este é o fluxo padrão e preferido
Experiência do Usuário
“Eu clico em Comprar e o dinheiro é reservado.”
Nenhuma etapa de pagamento adicional é necessária.
Fluxo do Sistema
Comprador clica em Comprar
OfferHub cria o escrow
Comprador financia o escrow a partir do saldo Airtm
Escrow fica financiado
Propriedades Chave
Os fundos se movem diretamente do comprador para o escrow
O marketplace nunca toca nos fundos do usuário
O escrow é financiado imediatamente
O vendedor pode prosseguir com segurança
Este é o caminho mais limpo e seguro, e aquele em torno do qual o Offer Hub foi projetado primeiro.
Caminho B — Comprador NÃO Tem Saldo Suficiente (Pagar-para-Escrow)
⚠️ Este caminho requer validação com a equipe da Airtm Ele está incluído aqui como um padrão educacional e voltado ao futuro.
Quando Isso Acontece
Comprador é aprovado em KYC na Airtm
Comprador não tem saldo suficiente
Comprador ainda quer concluir a compra imediatamente
Experiência do Usuário
“Eu clico em Comprar e escolho como pagar.”
O usuário pode ver:
cartão de débito
cartão de crédito
transferência bancária (ACH, transferência, etc.)
Mas ainda nunca vê cripto ou stablecoins.
Fluxo do Sistema (Proposto / A Ser Validado)
Comprador clica em Comprar
OfferHub cria escrow (pendente de financiamento)
Comprador seleciona método de pagamento via Airtm
O pagamento financia o escrow diretamente
Escrow fica financiado
Notas Importantes
Fundos não devem liquidar em uma conta da plataforma
A intenção é pagar → escrow, não pagar → saldo → escrow
Isto preserva:
garantias não custodiais
contabilidade limpa
fronteiras de confiança corretas
Se a Airtm pode suportar fluxos de pagamento direto-para-escrow é um item chave de validação para o piloto.
O Que Acontece a Seguir (Ambos os Caminhos)
Uma vez que o escrow é financiado:
O vendedor é notificado
O pedido entra em Em Andamento
A entrega pode começar
A lógica de disputa e aprovação se aplica de forma idêntica
A partir deste ponto, ambos os caminhos convergem.
Resultados
✅ Escrow criado e financiado
✅ Estado do pedido atualizado
✅ Vendedor notificado
✅ Trilha de auditoria criada (off-chain + on-chain)
Cenários de Falha
Saldo Insuficiente (Caminho A)
Criação do pedido bloqueada
Comprador solicitado a recarregar ou usar o Caminho B
Falha no Pagamento (Caminho B)
Escrow permanece sem financiamento
Pedido não inicia
Comprador tenta o pagamento novamente
Falha no Financiamento do Escrow
Pedido marcado como falhado
Nenhuma entrega permitida
Retentativa manual ou automatizada
Resumo Educacional
Comprador tem fundos
Clicar em Comprar
Escrow financiado instantaneamente
Comprador não tem fundos
Clicar em Comprar → Pagar
Escrow financiado após o pagamento
Plataforma
—
Nunca retém fundos
Vendedor
—
Protegido por escrow
Invariante Chave (Muito Importante)
Nenhum pedido pode entrar em “Em Andamento” a menos que o escrow esteja totalmente financiado.
Esta é a garantia de segurança central que o Offer Hub aplica.
Atualizado