Pular para o conteúdo principal

Fluxo de entrada

Esta página descreve o caminho completo de um portador de cartão no seu programa, do cadastro ao primeiro pagamento. Cada passo corresponde a chamadas de API específicas, para você montar o fluxo inteiro dentro do seu produto.

API v1 · Legado

Esta página faz parte da referência da primeira versão da API da Web3Card, mantida aqui para consulta. A API v1 não recebe integrações novas: a API v2 a substitui, e a plataforma hoje funciona como descrito no resto deste manual.

Visão geral do fluxo​

Signup → Wallet link → KYC → Vault deployment → Card creation → Top-up → First payment

1. Cadastro​

Crie o usuário com o e-mail dele. O e-mail é confirmado com um código de uso único enviado pela plataforma.

  • POST /users: cria o usuário
  • POST /users/{id}/email/verify: confirma o código

O usuário prova que a carteira é dele assinando uma mensagem (Sign-In with Ethereum). A carteira passa a ser a identidade de acesso do usuário e a dona do cofre dele.

  • POST /auth/nonce: gera a mensagem a assinar
  • POST /auth/verify: confere a assinatura SIWE

3. KYC​

A verificação de identidade é exigida pela bandeira e pelo emissor. A Web3Card oferece um fluxo de verificação hospedado, que você pode embutir ou abrir por redirecionamento.

  • POST /users/{id}/kyc/session: abre uma sessão de verificação
  • Webhook kyc.approved ou kyc.rejected: avisa o resultado

4. Implantação do cofre​

Com o KYC aprovado, implante o cofre multisig individual do usuário na rede escolhida. A carteira do usuário fica registrada como dona; o operador de liquidação entra como cossignatário só para as liquidações autorizadas do cartão.

  • POST /vaults: implanta o cofre
  • GET /vaults/{id}: consulta a situação da implantação

5. Criação do cartão​

Crie um cartão virtual na hora, ou abra o pedido de um cartão físico com entrega no mundo todo.

  • POST /cards: cria um cartão virtual
  • POST /card-orders: pede um cartão físico

6. Recarga​

O usuário abastece o cofre transferindo USDC, USDT ou o token do seu projeto para o endereço do cofre na rede escolhida. As mudanças de saldo chegam por webhook.

7. Primeiro pagamento​

O cartão está ativo. Os pagamentos são autorizados na hora contra o saldo do cofre, e cada transação fica disponível pela API e pelos webhooks.

Para os detalhes de cada etapa, veja a seção de guias.

Última atualização em