Cofres
O cofre é o coração do desenho não custodial da Web3Card. Cada cartão tem por trás o seu próprio cofre multisig em contrato inteligente, implantado na rede escolhida pelo portador.
Esta página faz parte da referência da primeira versão da API da Web3Card, mantida aqui para consulta. A API v1 não recebe integrações novas: a API v2 a substitui, e a plataforma hoje funciona como descrito no resto deste manual.
Como o cofre funciona
- Individual. Um cofre por cartão. O dinheiro nunca é misturado com o de outros usuários nem com o do operador do programa.
- Do usuário. A carteira do portador é a dona do cofre. O operador de liquidação da Web3Card é um cossignatário autorizado só a executar as liquidações dos pagamentos que o usuário fez com o cartão.
- Transparente. O cofre é um contrato numa rede pública. Cada liquidação é uma transação verificável na rede.
O que o cofre guarda
O cofre guarda o saldo disponível do cartão na moeda de liquidação do programa e, se as recargas com token estiverem ligadas, também o token do seu projeto (veja Redes e tokens).
Liquidação
Quando o portador paga com o cartão, o pagamento é autorizado na hora contra o saldo do cofre. Depois, a liquidação leva o valor autorizado do cofre, pelo operador de liquidação, até o banco emissor, como uma liquidação padrão da Visa. O caminho inteiro está no ciclo da transação.
Saques
O portador pode sacar do cofre quando quiser, assinando o saque com a carteira dona:
POST /vaults/{id}/withdrawals: prepara os dados da transação de saque- O usuário assina e envia com a própria carteira
O valor disponível para saque só diminui pelo que já foi autorizado e ainda não liquidado.
Limites de gasto na rede
O contrato do cofre repete os limites diários do cartão, como uma segunda camada de proteção: mesmo um caminho de autorização comprometido não consegue liquidar mais do que o limite da rede permite.
API de cofres
Os endereços de implantação, configuração, saldo e saque estão na referência da API de cofres.