Pular para o conteúdo principal

Pedir cartões físicos

Os cartões físicos levam a arte do seu programa e são enviados para o mundo todo. O pedido segue uma pequena sequência de situações: você cria o pedido, ele é produzido e enviado, e o portador ativa o cartão quando recebe.

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.

Situações do pedido​

created → confirmed → in_production → shipped → delivered → activated

O pedido pode ser cancelado enquanto está em created ou confirmed. Depois de in_production, não dá mais para cancelar.

Crie o pedido​

curl -X POST https://api.web3card.dev/v1/card-orders \
  -H "Authorization: Bearer w3c_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "usr_9f4c",
    "shippingAddress": {
      "line1": "Av. Paulista 1000",
      "city": "Sao Paulo",
      "state": "SP",
      "postalCode": "01310-100",
      "country": "BR"
    }
  }'
{
  "id": "ord_51de",
  "userId": "usr_9f4c",
  "status": "created",
  "estimatedDelivery": "2026-08-04",
  "createdAt": "2026-07-19T14:00:00Z"
}

Acompanhe o pedido​

curl https://api.web3card.dev/v1/card-orders/ord_51de \
  -H "Authorization: Bearer w3c_live_xxxxxxxxxxxxxxxx"

As mudanças de situação do pedido também chegam pelo webhook card_order.updated, com o código de rastreio da transportadora depois do envio.

Ativação​

Ao receber, o portador ativa o cartão confirmando os quatro últimos dígitos e criando uma senha (PIN), no seu app pela API ou na tela do elemento seguro:

curl -X POST https://api.web3card.dev/v1/cards/card_8a1f/activate \
  -H "Authorization: Bearer w3c_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "last4": "5678" }'

O cartão físico liquida contra o mesmo cofre do cartão virtual do usuário, com o mesmo saldo e os mesmos limites.

Última atualização em