Pular para o conteúdo principal

API de cofres

Implante e gerencie os cofres multisig em contrato inteligente que ficam por trás de cada cartão. Veja Cofres.

API v1 · Legado

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.

POST /vaults​

Implanta um cofre para um usuário com KYC aprovado.

// Request
{ "userId": "usr_9f4c", "chain": "polygon", "currency": "USDC" }

// Response
{
  "id": "vlt_77aa",
  "userId": "usr_9f4c",
  "chain": "polygon",
  "currency": "USDC",
  "address": null,
  "status": "deploying",
  "createdAt": "2026-07-19T14:00:00Z"
}

A implantação é assíncrona. O cofre passa a active quando o contrato está no ar, e o campo address é preenchido. Sai um webhook vault.deployed.

GET /vaults/{id}​

Consulta um cofre: endereço, situação e saldo disponível.

// Response
{
  "id": "vlt_77aa",
  "userId": "usr_9f4c",
  "chain": "polygon",
  "currency": "USDC",
  "address": "0x8247E5a9c11b36c1d19D4a2e9Eb0cE3606eB48a3",
  "balance": "487.35",
  "status": "active"
}

balance é o valor que pode ser gasto: o saldo na rede menos as reservas de autorizações pendentes.

GET /vaults​

Lista os cofres. Filtros: userId, chain, status.

GET /vaults/{id}/owners​

Lista as carteiras donas do cofre.

POST /vaults/{id}/owners​

Inclui uma carteira dona. Pede uma sessão do usuário; devolve os dados tipados EIP-712 para o dono atual assinar.

DELETE /vaults/{id}/owners/{address}​

Tira uma carteira dona. Pede uma sessão do usuário e a assinatura do dono.

POST /vaults/{id}/withdrawals​

Prepara um saque do cofre para a carteira do dono. Devolve os dados da transação para o dono assinar e enviar com a própria carteira.

// Request
{ "amount": "200.00", "to": "0x71C2a4f3b7c48d19D4a2e9Eb0cE3606eB48a3a4F" }

// Response
{
  "to": "0x8247E5a9c11b36c1d19D4a2e9Eb0cE3606eB48a3",
  "data": "0xa9059cbb…",
  "value": "0",
  "chainId": 137
}

O saque nunca depende de aprovação da plataforma: o dono do cofre sempre pode sair com o próprio dinheiro.

Última atualização em