Emita e recarregue cartões virtuais por API.

Como emitir um cartão virtual com cripto pela API

Deposite uma moeda e rede habilitadas e aguarde o crédito do saldo em USDT. Crie uma chave com payments:write e cards:write, além de leitura para as consultas.

1. Monte a operação com type: card, name e holderName. Cor e carga inicial são opcionais conforme o contrato.
2. Envie a operação a POST /quotes para consultar os custos.
3. Revise a cotação e envie a criação a POST /operations com o teto em max_debit_micros e a chave de idempotência.
4. Acompanhe o ID retornado e consulte o cartão criado em GET /cards.

Veja POST /operations para o corpo completo de emissão.

Como recarregar um cartão existente

Localize o cartão por GET /cards ou GET /cards/{id}. A recarga usa uma operação do tipo topup, com cardId e cents. Simule o custo antes de confirmar, seguindo o mesmo fluxo de cotação e idempotência.

O saldo da carteira em USDT e o saldo do cartão para compras são separados. Ter cripto na carteira não recarrega automaticamente o cartão. Acompanhe a operação de recarga e o extrato para confirmar o valor efetivamente creditado.

Custos e limites de cartões

Na configuração verificada, a emissão custa R$ 5 por cartão, a recarga tem tarifa de 3% e há R$ 0,70 por compra, com até 10 cartões por conta. As mesmas condições da conta se aplicam às operações iniciadas por API.

Consulte GET /fees para os termos atuais e POST /quotes para o custo da operação. Verifique a tabela de tarifas; emissão, recarga e compra são cobranças diferentes.

Emissão com carga inicial e resultado parcial

Uma resposta 202 significa que a operação foi aceita para processamento; ainda não comprova a conclusão. Salve data.id e acompanhe em GET /operations/{id}, por webhook ou callback. Se houver timeout, consulte a operação e repita com a mesma Idempotency-Key e o mesmo corpo. Uma nova chave pode criar outra operação.

Uma emissão com recarga inicial envolve mais de uma transação e pode ter resultado parcial. Confira as transações associadas, eventuais falhas e devoluções. Não presuma que um cartão deixou de ser criado apenas porque a recarga falhou; consulte a lista de cartões antes de tentar novamente.

O que a API de cartões disponibiliza

A API pública permite emissão, recarga e consulta dos cartões da conta. Número completo, CVV e bloqueio ou desbloqueio permanecem no painel. A API não fornece um programa de emissão independente nem cria automaticamente contas para os clientes do seu produto.

As chamadas usam a conta CriptoCore e o saldo real em produção. Não há sandbox público. Consulte GET /capabilities, GET /fees e a cotação antes de operar. Disponibilidade, saldo, permissões e limites da conta continuam valendo para a API.

Dúvidas frequentes