get_card
Obtém os cartões Picnic do utilizador (Gnosis Pay): tipo, últimos quatro dígitos mascarados, estado, saldos, limites de gasto e o endereço da smart account que suporta o cartão.
Dados sensíveis como PAN/CVV/validade nunca são devolvidos por esta ferramenta — para isso é necessária a cerimónia de passkey diretamente na app.
Âmbito necessário: read:card
Parâmetros:
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
card_type | enum | não | virtual, physical ou all (predefinido). |
include_void | boolean | não | Inclui cartões cancelados/fechados. Predefinição false (apenas cartões ativos e congelados). |
Campos devolvidos (por cartão):
| Campo | Tipo | Descrição |
|---|---|---|
cardId | string | null | Identificador interno do cartão. |
cardName | string | null | Etiqueta opcional definida pelo utilizador. |
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 utilizador ou pelo sistema. |
isStolen, isLost, isBlocked, isVoid | boolean | Flags de estado. |
accountBalances.total | string | null | Saldo total da Safe — formato decimal no token de settlement (ex.: "32.266959161447336568" EURe). String, tal como formattedAmount em get_balances. |
accountBalances.spendable | string | null | Saldo disponível para 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 em get_balances. |
smartAccountAddress | string | Endereço da smart account Gnosis Pay que suporta o cartão. |
chainId | number | Cadeia onde a conta do cartão vive. |
delayModuleLockedUntil | date | null | Se houver uma alteração no delay-module em fila, quando desbloqueia. |
accountBalances é partilhado entre todos os cartões na mesma smartAccountAddress — cartões virtuais e físicos numa mesma Safe gastam do mesmo saldo, pelo que o valor populado é propagado para os cartões irmãos.
Exemplo de pergunta:
"O meu cartão está congelado? Qual é o saldo disponível?"