Pular para o conteúdo principal

Recargas

O cartão pode gastar enquanto o cofre dele tem saldo. O usuário recarrega transferindo tokens aceitos para o endereço do cofre; não é preciso chamar a API para receber, mas a API traz tudo o que você precisa para uma boa experiência de recarga.

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.

Pegue o endereço de depósito​

O endereço do cofre é o endereço de depósito. Mostre-o (com um QR code) no seu app:

curl https://api.web3card.dev/v1/vaults/vlt_77aa \
  -H "Authorization: Bearer w3c_live_xxxxxxxxxxxxxxxx"
{
  "id": "vlt_77aa",
  "userId": "usr_9f4c",
  "chain": "polygon",
  "address": "0x8247E5a9c11b36c1d19D4a2e9Eb0cE3606eB48a3",
  "currency": "USDC",
  "balance": "487.35",
  "status": "active"
}
cuidado

O depósito precisa ser feito na rede do cofre. Tokens enviados em outra rede não são creditados sozinhos; recuperar exige intervenção manual do suporte.

Recargas com stablecoin​

As transferências na moeda de liquidação do cofre (USDC ou USDT) são creditadas assim que a transferência fica definitiva na rede do cofre. Um webhook vault.credited sai com o valor e o hash da transação.

Recargas com o token do projeto​

Se o seu programa aceita recarga com token, as transferências do token do seu projeto para o cofre são convertidas na moeda de liquidação pelo preço de mercado e creditadas como saldo em stablecoin. Os detalhes da conversão vêm no evento do webhook:

{
  "type": "vault.credited",
  "data": {
    "vaultId": "vlt_77aa",
    "source": "token_conversion",
    "tokenIn": "YOURTOKEN",
    "amountIn": "1500.00",
    "currency": "USDC",
    "amountCredited": "487.35",
    "rate": "0.32490",
    "txHash": "0x9c2f…e11a"
  }
}

Mostrar o saldo​

Use GET /vaults/{id} para o saldo oficial. O campo balance já desconta o que está reservado por autorizações pendentes, então pode ser mostrado como "disponível para gastar".

Última atualização em