Saldo e taxas
GET /crypto/balance → 200
Seção intitulada “GET /crypto/balance → 200”Requer scope CRYPTO_READ.
curl -s https://api.gestaotechnology.com/api/crypto/balance \ -H "X-Api-Key: <SECRET_KEY>"{ "currency": "USDC", "available": "6.710000", "pending": "0.000000", "reserved": "1.000000" }| Campo | O que é |
|---|---|
available | Pode ser usado em saques. |
pending | Depósitos recebidos que ainda estão sendo liquidados (viram available em alguns minutos). |
reserved | Preso em saques em andamento ou em análise. |
A taxa cripto é configurada por loja, separada da taxa Pix: um percentual mais um valor fixo no depósito e outro no saque. Ela é calculada sobre o valor em reais e descontada na própria operação, sem cobrança separada:
| Operação | Como a taxa entra | Onde ver |
|---|---|---|
| Depósito | O valor recebido entra como pendente; ao ficar disponível, a taxa já foi descontada. | fee no webhook crypto.deposit.paid |
| Pagar o cliente | Descontada do valor pedido: o cliente recebe cerca de valor − taxa. | fee na resposta e nos webhooks crypto.payout.* |
| Sacar o saldo da loja | Descontada do valor pedido. | fee na resposta e nos webhooks crypto.withdrawal.* |
O provedor cripto fica com a parte dele na conversão (Pix ⇄ USDC). Esse custo já está embutido no amountUsdc do depósito e no deliveredBrl dos saques. Se a taxa configurada para a sua loja não cobrir esse custo num saque, ele é recusado antes de reservar qualquer valor: 422 provider_cost_exceeds_fee.