Cards Overview
Agio Cards are crypto-collateralized Visa credit cards backed by stablecoin deposits (USDC or PYUSD). Depositing stablecoins into a Agio Card smart wallet establishes a credit limit, and cardholders can spend up to that limit using virtual or physical Visa cards anywhere Visa is accepted.
All card operations are performed via GraphQL through the Agio Platform API.
Card Lifecycle
Virtual vs Physical Cards
| Feature | Virtual | Physical |
|---|---|---|
| Availability | Instant — ready to use immediately | Ships globally (free standard shipping) |
| Use cases | Online purchases, subscriptions | In-person, ATM, tap-to-pay |
| Shipping | Not required | Required (address + phone number) |
| PIN | Set at creation | Staged at creation, activated on receipt |
| Replacement | replaceVirtualCard — new card number instantly | replaceCard with shipping address |
| Spending limits | Configurable (rolling period) | Configurable (rolling period) |
| Cancellation | Permanent, irreversible | Permanent, irreversible |
Quick Reference
| Action | GraphQL Operation | Type |
|---|---|---|
| List cards | vwCards | Query |
| Apply (individual) | createCardApplication | Mutation |
| Apply (corporate) | createCardCorporateApplication | Mutation |
| Create card | createCard | Mutation |
| Freeze card | freezeCard | Mutation |
| Unfreeze card | unfreezeCard | Mutation |
| Cancel card | cancelCard | Mutation |
| Replace virtual card | replaceVirtualCard | Mutation |
| Replace any card | replaceCard | Mutation |
| Update spending limit | updateCardLimit | Mutation |
| Set PIN | setCardPin | Mutation |
| Reveal PIN | getCardPin | Mutation |
| Reveal card secrets | revealCardSecrets | Mutation |
| Rename card | updateCardNickname | Mutation |
| Star/unstar card | updateCardStarred | Mutation |
| Fund card | smartWalletSwapQuote → smartWalletExecuteSwapQuote | Mutation |
| Withdraw collateral | cardWithdraw | Mutation |
| Card balance | cardBalance | Query |
| View transactions | UserCardTransactions | Query |
| Real-time transactions | CardTransactionUpdates | Subscription |
| Application updates | CardApplicationUpdates | Subscription |
Amounts in Cents
All monetary amounts in the Agio Card API are in cents (smallest currency unit). 50000 = $500.00. The only exception is cardWithdraw, which accepts human-readable token amounts (e.g., "100.5").