# Web3Card Docs

> White-label crypto card infrastructure for web3 projects. Visa cards funded by stablecoins, under your brand and your domain.

## Docs

- [Welcome to Web3Card](https://docs.web3card.dev/): Web3Card is white-label software for card programs. Visa cards funded by stablecoins, under your brand and your domain. Start here to learn how the platform works.
- [Card playground](https://docs.web3card.dev/playground/): Design a sample virtual card with the options of Card setup, turn it in 3D and see what each card action does to it. Preview your brand, theme and accent color in the app of your users.
- [Flow builder](https://docs.web3card.dev/flow-builder/): Pick a token on Ethereum, BNB Chain, Arbitrum, Polygon or Base and choose where it ends, your wallet, your program contract or a Visa card. See the route drawn step by step and the API calls for each step.
- [How the platform works](https://docs.web3card.dev/platform/overview/): Web3Card has two sides. The Business panel is where a company sets up and operates its card program. The Personal app is where its users create an account and use their cards.
- [White-label: your brand, your domain](https://docs.web3card.dev/platform/white-label/): What white-label means on Web3Card. Your users see your name, your logo, your colors and your domain. Learn what changes per company and how your own domain works.
- [From sign-up to launch](https://docs.web3card.dev/platform/path-to-launch/): The path of a company on Web3Card, step by step, from creating the Business account to operating a card program. Subscription, the two verifications, the program contract, the cards and the white label, with the status of each step.
- [Countries and regions](https://docs.web3card.dev/cards/countries/): Where Web3Card cards don't work, the countries and regions blocked by international sanctions, and the countries where cards can be used with Apple Pay.
- [Create a Business account](https://docs.web3card.dev/access/create-business-account/): Step-by-step guide to open your company on Web3Card. Fill in the first form, confirm your email, set up an authenticator app and confirm your mobile number.
- [Create a Personal account](https://docs.web3card.dev/access/create-personal-account/): Step-by-step guide for the end user of a card program. Create your account in the company's app, confirm your email, set up an authenticator app and confirm your mobile number.
- [Sign in and sign out](https://docs.web3card.dev/access/sign-in/): How to sign in to the Web3Card Business panel or to a Personal app, and how to sign out. Every sign-in asks for your password and a code from your authenticator app.
- [Reset your password](https://docs.web3card.dev/access/reset-password/): Forgot your password? Ask for a 6-digit code by email and choose a new password. No link is sent. Works the same in the Business panel and in the Personal app.
- [Lost your phone: replace the authenticator](https://docs.web3card.dev/access/replace-authenticator/): Lost or changed the phone with your authenticator app? Replace it with your password and a code sent to your email. No SMS and no recovery codes are needed.
- [Security rules and limits](https://docs.web3card.dev/access/security-and-limits/): Reference of the access rules on Web3Card. Password rules, how long each code works, SMS limits, session duration, every message of the access screens, and what the platform never asks you for.
- [API v2 overview](https://docs.web3card.dev/api/overview/): What the Web3Card API v2 is and how it is designed. One API to operate a card program, with asynchronous operations, safe retries and signed events. The reference is planned.
- [Quickstart](https://docs.web3card.dev/getting-started/quickstart/): API v1 (legacy): from an API key to the first virtual card in five calls. Create a user, complete KYC, deploy the vault and create the card, with cURL examples.
- [Integration Models](https://docs.web3card.dev/getting-started/integration-models/): API v1 (legacy): the two integration models of the first version, white-label and custom, and how they compare: artwork, approval, time to launch and support.
- [Onboarding Flow](https://docs.web3card.dev/getting-started/onboarding-flow/): API v1 (legacy): the journey of a cardholder from signup to first payment, step by step, with the API calls of each step: signup, wallet link, KYC, vault, card and top-up.
- [Cards](https://docs.web3card.dev/concepts/cards/): API v1 (legacy): virtual and physical cards, card statuses, spending controls and the one card, one vault model of the first version of the API.
- [Vaults](https://docs.web3card.dev/concepts/vaults/): API v1 (legacy): how the multisig smart-contract vault behind each card works in the first version: ownership, settlement, withdrawals and on-chain spending limits.
- [Chains & Tokens](https://docs.web3card.dev/concepts/chains-and-tokens/): API v1 (legacy): supported chains, settlement stablecoins (USDC and USDT) and top-ups in a project token, converted at market rate.
- [Transaction Lifecycle](https://docs.web3card.dev/concepts/transaction-lifecycle/): API v1 (legacy): the path of a card payment, from authorization to clearing and on-chain settlement, with transaction statuses, refunds, disputes and real-time events.
- [Create Virtual Cards](https://docs.web3card.dev/guides/create-virtual-cards/): API v1 (legacy): create a virtual card, show its details through a secure element, add it to Apple Pay and Google Pay, and freeze or void it, with cURL and JSON examples.
- [Order Physical Cards](https://docs.web3card.dev/guides/order-physical-cards/): API v1 (legacy): order a physical card with your program's artwork, follow the order from production to delivery, and activate the card, with cURL and JSON examples.
- [Top-ups](https://docs.web3card.dev/guides/top-ups/): API v1 (legacy): fund a card with stablecoins or a project token, get the deposit address, follow vault credits by webhook and display the available balance.
- [Webhooks](https://docs.web3card.dev/guides/webhooks/): API v1 (legacy): subscribe your backend to card, transaction, KYC and vault events, verify HMAC SHA-256 signatures, the event catalog and the retry policy.
- [API Reference](https://docs.web3card.dev/api-reference/overview/): API v1 (legacy) reference: base URL, authentication, live and sandbox environments, error format and status codes, cursor pagination and idempotency keys.
- [Authentication](https://docs.web3card.dev/api-reference/authentication/): API v1 (legacy): partner API keys as Bearer tokens, user sessions with Sign-In with Ethereum (SIWE) and email verification, with request and response examples.
- [Users & KYC](https://docs.web3card.dev/api-reference/users-and-kyc/): API v1 (legacy): create, retrieve and list users, start a hosted KYC verification session, follow the KYC statuses and verify the phone number.
- [Cards API](https://docs.web3card.dev/api-reference/cards/): API v1 (legacy): every card endpoint, with examples: create, list and retrieve cards, activate, freeze, unfreeze, report lost or stolen, void, daily limits and secure sessions.
- [Vaults API](https://docs.web3card.dev/api-reference/vaults/): API v1 (legacy): deploy, retrieve and list vaults, manage owner wallets and prepare withdrawals to the owner's wallet, with request and response examples.
- [Transactions API](https://docs.web3card.dev/api-reference/transactions/): API v1 (legacy): list and retrieve card transactions with their on-chain settlement hash, the dispute reason codes and how to open a dispute.
- [Webhooks API](https://docs.web3card.dev/api-reference/webhooks/): API v1 (legacy): create, list, update, delete and test webhook subscriptions, rotate the signing secret, and the delivery format with its headers.
- [Glossary](https://docs.web3card.dev/glossary/): The terms used in the Web3Card documentation, each explained in one or two sentences. Business panel, Personal app, white-label, card program, authenticator app, KYC and more.

## Optional

- [Full text of every page](https://docs.web3card.dev/llms-full.txt)