Pular para o conteúdo principal

API de cartões

Crie e gerencie os cartões do seu programa. As situações e o ciclo de vida estão em Cartões.

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 /cards​

Cria um cartão virtual para um usuário com cofre ativo.

// Request
{ "userId": "usr_9f4c", "type": "virtual" }

// Response
{
  "id": "card_3b7c",
  "userId": "usr_9f4c",
  "vaultId": "vlt_77aa",
  "type": "virtual",
  "status": "active",
  "last4": "1234",
  "network": "visa",
  "createdAt": "2026-07-19T14:00:00Z"
}

GET /cards​

Lista os cartões. Filtros: userId, status, type.

GET /cards/{id}​

Consulta um cartão e a situação dele.

POST /cards/{id}/activate​

Ativa um cartão físico entregue.

// Request
{ "last4": "5678" }

POST /cards/{id}/freeze​

Bloqueia as autorizações por um tempo. Volta atrás.

POST /cards/{id}/unfreeze​

Tira o congelamento e devolve o cartão a active.

POST /cards/{id}/report-lost​

Bloqueia de vez um cartão comunicado como perdido. Definitivo.

POST /cards/{id}/report-stolen​

Bloqueia de vez um cartão comunicado como roubado. Definitivo.

POST /cards/{id}/void​

Cancela um cartão virtual. Definitivo. O cofre e o saldo dele não mudam.

GET /cards/{id}/limits​

// Response
{ "daily": { "amount": "1000.00", "currency": "USDC", "spentToday": "112.40" } }

PUT /cards/{id}/limits​

Define o limite diário. Pede uma sessão do usuário (assinada pelo dono do cofre).

// Request
{ "daily": { "amount": "2500.00" } }

POST /cards/{id}/secure-session​

Cria uma sessão de uso único do elemento seguro, para mostrar os dados completos do cartão ao portador. Veja Criar cartões virtuais.

Última atualização em