# Cripto (USDT)

Converte parte do seu saldo em reais para USDT e envia direto para uma carteira. O valor sai do saldo disponível na hora em que a conversão é criada; se o envio falhar, volta inteiro.

> ✅ Para converter e **guardar** USDT na sua carteira StacePay, sem enviar para fora, use [Carteiras e conversão](https://stacepay.com.br/docs/carteiras). Esta rota continua disponível para quem já integra o envio direto.

## Criptomoedas disponíveis

| Moeda | Redes | Origem |
| --- | --- | --- |
| `USDT` (Tether) | `TRC20` (Tron) | Saldo em BRL |

A lista vale para o momento da consulta. Para saber em tempo real, use:

`GET /crypto/assets`

_json_

```json
{
  "object": "list",
  "data": [
    {
      "object": "crypto_asset",
      "coin": "USDT",
      "name": "Tether",
      "networks": ["TRC20"],
      "source_currency": "BRL",
      "available": true
    }
  ]
}
```

## Cotação

Mostra quanto USDT chega na carteira, já descontadas a taxa StacePay e as taxas de conversão e envio da rede. Não debita nada.

`POST /crypto/quote`

| Campo | Tipo |  | Descrição |
| --- | --- | --- | --- |
| `amount` | integer | obrigatório | Valor em centavos de real a converter. |

_curl_

```bash
curl -X POST https://stacepay.com.br/api/v1/crypto/quote \
  -H "Authorization: Bearer nvx_live_..." \
  -H "Content-Type: application/json" \
  -d '{"amount": 50000}'
```

_json_

```json
{
  "object": "crypto_quote",
  "coin": "USDT",
  "currency": "BRL",
  "amount": 50000,
  "fee_amount": 1000,
  "net_amount": 49000,
  "amount_usdt": "84.12",
  "rate": "5.4100"
}
```

> ⚠️ A cotação muda com o dólar. O valor final é calculado de novo no momento da conversão. Se o valor não cobrir as taxas, a resposta é `422 below_min`.

## Criar conversão

`POST /crypto/conversions`

> ✅ Use um `Idempotency-Key`. KYC aprovado é obrigatório.

| Campo | Tipo |  | Descrição |
| --- | --- | --- | --- |
| `amount` | integer | obrigatório | Valor em centavos de real, debitado do saldo disponível. |
| `network` | string | obrigatório | Rede da carteira de destino. Hoje: "TRC20". |
| `wallet_address` | string | obrigatório | Endereço da carteira que recebe o USDT. |

_curl_

```bash
curl -X POST https://stacepay.com.br/api/v1/crypto/conversions \
  -H "Authorization: Bearer nvx_live_..." \
  -H "Idempotency-Key: cripto-0001" \
  -H "Content-Type: application/json" \
  -d '{"amount": 50000, "network": "TRC20", "wallet_address": "TXYZ..."}'
```

_json_

```json
{
  "object": "crypto_conversion",
  "id": "CR261110A1B2C3",
  "status": "processing",
  "coin": "USDT",
  "network": "TRC20",
  "currency": "BRL",
  "amount": 50000,
  "fee_amount": 1000,
  "net_amount": 49000,
  "wallet_address": "TXYZ...",
  "amount_usdt": "84.12",
  "tx_hash": null,
  "failure_reason": null,
  "created_at": "2026-11-10T15:20:00-03:00"
}
```

## Listar e buscar

`GET /crypto/conversions?limit=20&offset=0`

`GET /crypto/conversions/{id}`

Consulte a conversão até o status final. Quando concluída, `tx_hash` traz o hash da transação na rede.

## Status possíveis

| Status | Significado |
| --- | --- |
| `pending` | Criada, aguardando envio ao parceiro. |
| `processing` | Em conversão e envio para a carteira. |
| `completed` | USDT enviado. Veja `tx_hash`. |
| `failed` | Falhou; o valor em reais volta ao saldo. Motivo em `failure_reason`. |
| `canceled` | Cancelada; o valor volta ao saldo. |
