# Documentação Web3Card

> Infraestrutura white-label de cartões cripto para projetos web3. Cartões Visa recarregados com stablecoins, com a sua marca e o seu domínio.

## Docs

- [Boas-vindas à Web3Card](https://docs.web3card.dev/pt-BR/): A Web3Card é um software white-label para programas de cartões. Cartões Visa recarregados com stablecoins, com a sua marca e o seu domínio. Comece por aqui para entender como a plataforma funciona.
- [Playground de cartões](https://docs.web3card.dev/pt-BR/playground/): Desenhe um cartão virtual de exemplo com as opções do Card setup, gire-o em 3D e veja o que cada ação faz com ele. Veja a sua marca, o seu tema e a sua cor de destaque no app dos seus usuários.
- [Construtor de fluxos](https://docs.web3card.dev/pt-BR/flow-builder/): Escolha um token na Ethereum, BNB Chain, Arbitrum, Polygon ou Base e onde ele termina, a sua carteira, o contrato do seu programa ou um cartão Visa. Veja a rota desenhada passo a passo e as chamadas de API de cada passo.
- [Como a plataforma funciona](https://docs.web3card.dev/pt-BR/platform/overview/): A Web3Card tem dois lados. No painel Business a empresa configura e opera o seu programa de cartões. No app Pessoal os usuários dela criam a conta e usam os cartões.
- [White-label: a sua marca, o seu domínio](https://docs.web3card.dev/pt-BR/platform/white-label/): O que é white-label na Web3Card. Os seus usuários veem o seu nome, o seu logo, as suas cores e o seu domínio. Veja o que muda por empresa e como funciona o domínio próprio.
- [Do cadastro ao lançamento](https://docs.web3card.dev/pt-BR/platform/path-to-launch/): O caminho de uma empresa na Web3Card, passo a passo, da criação da conta Business à operação do programa de cartões. Inscrição, as duas verificações, o contrato do programa, os cartões e o white label, com a situação de cada passo.
- [Países e regiões](https://docs.web3card.dev/pt-BR/cards/countries/): Onde os cartões da Web3Card não funcionam, os países e regiões bloqueados por sanções internacionais, e os países onde os cartões podem ser usados com o Apple Pay.
- [Criar uma conta Business](https://docs.web3card.dev/pt-BR/access/create-business-account/): Passo a passo para abrir a sua empresa na Web3Card. Preencha o primeiro formulário, confirme o e-mail, configure um aplicativo autenticador e confirme o celular.
- [Criar uma conta Pessoal](https://docs.web3card.dev/pt-BR/access/create-personal-account/): Passo a passo para o usuário final de um programa de cartões. Crie a conta no app da empresa, confirme o e-mail, configure um aplicativo autenticador e confirme o celular.
- [Entrar e sair](https://docs.web3card.dev/pt-BR/access/sign-in/): Como entrar no painel Business da Web3Card ou em um app Pessoal, e como sair. Todo login pede a senha e um código do aplicativo autenticador.
- [Trocar a senha](https://docs.web3card.dev/pt-BR/access/reset-password/): Esqueceu a senha? Peça um código de 6 dígitos por e-mail e escolha uma senha nova. Nenhum link é enviado. Funciona igual no painel Business e no app Pessoal.
- [Perdeu o celular: trocar o autenticador](https://docs.web3card.dev/pt-BR/access/replace-authenticator/): Perdeu ou trocou o celular com o aplicativo autenticador? Troque o autenticador com a senha e um código enviado para o seu e-mail. Sem SMS e sem códigos de recuperação.
- [Regras de segurança e limites](https://docs.web3card.dev/pt-BR/access/security-and-limits/): Referência das regras de acesso na Web3Card. Regras de senha, por quanto tempo vale cada código, limites de SMS, duração da sessão, todas as mensagens das telas de acesso e o que a plataforma nunca pede a você.
- [Visão geral da API v2](https://docs.web3card.dev/pt-BR/api/overview/): O que é a API v2 da Web3Card e como ela foi desenhada. Uma API para operar um programa de cartões, com operações assíncronas, repetição segura e eventos assinados. A referência está planejada.
- [Início rápido](https://docs.web3card.dev/pt-BR/getting-started/quickstart/): API v1 (legado): da chave de API ao primeiro cartão virtual em cinco chamadas. Criar o usuário, fazer o KYC, implantar o cofre e criar o cartão, com exemplos em cURL.
- [Modelos de integração](https://docs.web3card.dev/pt-BR/getting-started/integration-models/): API v1 (legado): os dois modelos de integração da primeira versão, white-label e personalizado, e como eles se comparam: arte, aprovação, prazo de lançamento e suporte.
- [Fluxo de entrada](https://docs.web3card.dev/pt-BR/getting-started/onboarding-flow/): API v1 (legado): o caminho do portador do cadastro ao primeiro pagamento, passo a passo, com as chamadas de API de cada passo: cadastro, carteira, KYC, cofre, cartão e recarga.
- [Cartões](https://docs.web3card.dev/pt-BR/concepts/cards/): API v1 (legado): cartões virtuais e físicos, as situações do cartão, os controles de gasto e o modelo um cartão, um cofre da primeira versão da API.
- [Cofres](https://docs.web3card.dev/pt-BR/concepts/vaults/): API v1 (legado): como funciona o cofre multisig em contrato inteligente por trás de cada cartão na primeira versão: dono, liquidação, saques e limites na rede.
- [Redes e tokens](https://docs.web3card.dev/pt-BR/concepts/chains-and-tokens/): API v1 (legado): as redes aceitas, as stablecoins de liquidação (USDC e USDT) e as recargas com o token do projeto, convertidas pelo preço de mercado.
- [Ciclo da transação](https://docs.web3card.dev/pt-BR/concepts/transaction-lifecycle/): API v1 (legado): o caminho de um pagamento com o cartão, da autorização à compensação e à liquidação na rede, com as situações da transação, estornos, disputas e eventos na hora.
- [Criar cartões virtuais](https://docs.web3card.dev/pt-BR/guides/create-virtual-cards/): API v1 (legado): criar um cartão virtual, mostrar os dados dele por um elemento seguro, adicionar ao Apple Pay e ao Google Pay, e congelar ou anular, com exemplos em cURL e JSON.
- [Pedir cartões físicos](https://docs.web3card.dev/pt-BR/guides/order-physical-cards/): API v1 (legado): pedir um cartão físico com a arte do seu programa, acompanhar o pedido da produção à entrega e ativar o cartão, com exemplos em cURL e JSON.
- [Recargas](https://docs.web3card.dev/pt-BR/guides/top-ups/): API v1 (legado): abastecer o cartão com stablecoins ou com o token do projeto, pegar o endereço de depósito, acompanhar os créditos do cofre por webhook e mostrar o saldo disponível.
- [Webhooks](https://docs.web3card.dev/pt-BR/guides/webhooks/): API v1 (legado): assinar no seu backend os eventos de cartões, transações, KYC e cofres, conferir as assinaturas HMAC SHA-256, o catálogo de eventos e a política de novas tentativas.
- [Referência da API](https://docs.web3card.dev/pt-BR/api-reference/overview/): Referência da API v1 (legado): URL base, autenticação, ambientes de produção e sandbox, formato dos erros e códigos de situação, paginação por cursor e chaves de idempotência.
- [Autenticação](https://docs.web3card.dev/pt-BR/api-reference/authentication/): API v1 (legado): chaves de API de parceiro como token Bearer, sessões do usuário com Sign-In with Ethereum (SIWE) e confirmação do e-mail, com exemplos de pedido e resposta.
- [Usuários e KYC](https://docs.web3card.dev/pt-BR/api-reference/users-and-kyc/): API v1 (legado): criar, consultar e listar usuários, abrir uma sessão de verificação KYC hospedada, acompanhar as situações do KYC e confirmar o celular.
- [API de cartões](https://docs.web3card.dev/pt-BR/api-reference/cards/): API v1 (legado): todos os endereços de cartão, com exemplos: criar, listar e consultar cartões, ativar, congelar, descongelar, comunicar perda ou roubo, anular, limites diários e sessões seguras.
- [API de cofres](https://docs.web3card.dev/pt-BR/api-reference/vaults/): API v1 (legado): implantar, consultar e listar cofres, gerenciar as carteiras donas e preparar saques para a carteira do dono, com exemplos de pedido e resposta.
- [API de transações](https://docs.web3card.dev/pt-BR/api-reference/transactions/): API v1 (legado): listar e consultar as transações dos cartões, com o hash da liquidação na rede, os motivos de disputa e como abrir uma disputa.
- [API de webhooks](https://docs.web3card.dev/pt-BR/api-reference/webhooks/): API v1 (legado): criar, listar, alterar, apagar e testar assinaturas de webhook, trocar o segredo de assinatura, e o formato da entrega com os cabeçalhos.
- [Glossário](https://docs.web3card.dev/pt-BR/glossary/): Os termos usados na documentação da Web3Card, cada um explicado em uma ou duas frases. Painel Business, app Pessoal, white-label, programa de cartões, aplicativo autenticador, KYC e outros.

## Optional

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