Pular para o conteúdo principal

Criar cartões virtuais

Os cartões virtuais são criados na hora e ficam prontos para compras on-line e para as carteiras digitais (Apple Pay / Google Pay) assim que o cofre por trás deles tem saldo.

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.

Antes de começar​

  • Usuário criado e e-mail confirmado
  • KYC aprovado (webhook kyc.approved recebido)
  • Cofre do usuário implantado

Crie o cartão​

curl -X POST https://api.web3card.dev/v1/cards \
  -H "Authorization: Bearer w3c_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "userId": "usr_9f4c", "type": "virtual" }'
{
  "id": "card_3b7c",
  "userId": "usr_9f4c",
  "type": "virtual",
  "status": "active",
  "last4": "1234",
  "network": "visa",
  "vaultId": "vlt_77aa",
  "createdAt": "2026-07-19T14:00:00Z"
}

Mostre os dados do cartão com segurança​

A API nunca devolve os dados completos do cartão. Para mostrar número, validade e CVV ao portador, embuta o elemento seguro: um iframe hospedado, compatível com PCI, preso a um cartão e a uma sessão.

curl -X POST https://api.web3card.dev/v1/cards/card_3b7c/secure-session \
  -H "Authorization: Bearer w3c_live_xxxxxxxxxxxxxxxx"
{ "url": "https://secure.web3card.dev/e/card_3b7c?st=abc123", "expiresIn": 300 }

Mostre o endereço devolvido num iframe dentro do seu app. A sessão vale uma vez e expira em cinco minutos.

Carteiras digitais​

O portador pode adicionar o cartão virtual ao Apple Pay e ao Google Pay direto pela tela do elemento seguro, ou o seu app pode fazer isso por código, se estiver cadastrado nas carteiras.

Congelar e anular​

# Freeze (reversible)
curl -X POST https://api.web3card.dev/v1/cards/card_3b7c/freeze \
  -H "Authorization: Bearer w3c_live_xxxxxxxxxxxxxxxx"

# Void (terminal)
curl -X POST https://api.web3card.dev/v1/cards/card_3b7c/void \
  -H "Authorization: Bearer w3c_live_xxxxxxxxxxxxxxxx"

Anular um cartão não mexe no cofre: o saldo do usuário fica intacto e um cartão novo pode ser criado com o mesmo cofre.

Última atualização em