get_card
Pega os cartões Picnic do usuário (Gnosis Pay): tipo, últimos quatro dígitos mascarados, status, saldos, limites de gasto e o endereço da smart account que dá lastro ao cartão.
Dados sensíveis como PAN/CVV/validade nunca são retornados por essa ferramenta — pra acessar isso, é preciso fazer a cerimônia de passkey direto no app.
Escopo necessário: read:card
Parâmetros:
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
card_type | enum | não | virtual, physical ou all (padrão). |
include_void | boolean | não | Inclui cartões cancelados/fechados. Padrão false (só cartões ativos e congelados). |
Campos retornados (por cartão):
| Campo | Tipo | Descrição |
|---|---|---|
cardId | string | null | ID interno do cartão. |
cardName | string | null | Apelido opcional definido pelo usuário. |
cardType | enum | virtual ou physical. |
lastFourDigits | string | null | Últimos quatro dígitos do PAN, mascarados. |
isActivated | boolean | True se o cartão já foi ativado. |
activatedAt | date | null | Quando o cartão foi ativado. |
isFrozen | boolean | Cartão congelado pelo usuário ou sistema. |
isStolen, isLost, isBlocked, isVoid | boolean | Flags de status. |
accountBalances.total | string | null | Saldo total da Safe — formato decimal no token de settlement (ex: "32.266959161447336568" EURe). String, igual o formattedAmount em get_balances. |
accountBalances.spendable | string | null | Saldo disponível pra gastar (já liquidado, sem reservas). |
accountBalances.pending | string | null | Saldo pendente (transações em liquidação). |
allowances.refill | string | null | Valor de refill por período — formato decimal no token de settlement. |
allowances.maxRefill | string | null | Refill máximo por período. |
allowances.balance | string | null | Saldo restante do limite atual. |
allowances.period | string | null | Período de refill em segundos. |
allowances.timestamp | string | null | Último refill — timestamp Unix em segundos. |
fiatSymbol | "EUR" | "USD" | "GBP" | Moeda fiat do cartão. |
tokenSymbol | string | Símbolo do token de settlement (ex: EURe, USDC). |
tokenAssetId | string | null | Identificador CAIP (opens in a new tab) do token de settlement (ex: eip155:100/erc20:0x420C…). Faz cross-reference com o mesmo token no get_balances. |
smartAccountAddress | string | Endereço da smart account Gnosis Pay que dá lastro ao cartão. |
chainId | number | Chain onde a conta do cartão vive. |
delayModuleLockedUntil | date | null | Se tem alguma mudança de delay-module enfileirada, quando destrava. |
accountBalances é compartilhado entre todos os cartões na mesma smartAccountAddress — cartões virtuais e físicos numa mesma Safe gastam do mesmo saldo, então o valor populado é propagado pros cartões irmãos.
Exemplo de pergunta:
"Meu cartão tá congelado? Qual o saldo disponível?"