Cartões
Um Web3Card é um cartão Visa com a marca do seu projeto, emitido por uma instituição parceira e com um cofre na rede por trás. Os cartões vêm em duas formas e têm o mesmo ciclo de vida e a mesma API.
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.
Cartões virtuais
Os cartões virtuais são criados na hora pela API. Os dados do cartão (número, validade, CVV) chegam ao portador por um elemento seguro embutido no seu app ou site, então os dados sensíveis nunca passam pelos seus servidores e o seu escopo de PCI DSS fica mínimo.
Os cartões virtuais já podem ser adicionados ao Apple Pay e ao Google Pay.
Cartões físicos
Os cartões físicos são produzidos com a arte do seu programa e enviados aos portadores no mundo todo. Um cartão físico começa como um pedido (veja Pedir cartões físicos) e precisa ser ativado pelo portador antes do primeiro uso.
Situações do cartão
| Situação | Significado |
|---|---|
pending | Criado, esperando a ativação (físico) ou a liberação (virtual) |
active | Pronto para usar |
frozen | Bloqueado por um tempo, pelo portador ou pelo seu programa |
lost | Comunicado como perdido; bloqueado de vez |
stolen | Comunicado como roubado; bloqueado de vez |
voided | Cartão virtual cancelado |
As mudanças de situação estão na API de cartões. frozen volta atrás; lost, stolen e voided são definitivas, e um cartão substituto pode ser criado com o mesmo cofre.
Controles de gasto
Cada cartão tem um limite diário de gasto, conferido no momento da autorização. O limite pode ser lido e alterado pela API, e a mudança vale na hora:
GET /cards/{id}/limitsPUT /cards/{id}/limits
Um cartão, um cofre
Cada cartão liquida contra o seu próprio cofre multisig individual. É essa relação de um para um que mantém o programa não custodial: congelar um cartão nunca trava o dinheiro do usuário, e o usuário pode sacar do cofre quando quiser. Veja Cofres.