←Trocar docs

Docs/Conversões

Conversões

Execute fluxos com source.asset=usdt para converter e liquidar em BRL com regras claras por pipeline.

Ver requisitos de autenticação

Schema de conversão

A API aceita combinações específicas de source e target. Use esta seção para validar campos e valores permitidos antes de montar o request.

source.type

balance | crypto_wallet

target.type

balance | pix

asset

brl | usdt

network (crypto)

eth | matic | trx | ton

Schema base do request
{
  "source": {
    "type": "balance | crypto_wallet",
    "asset": "usdt",
    "amount": "number",
    "network": "eth | matic | trx | ton (quando source.type = crypto_wallet)"
  },
  "target": {
    "type": "balance | pix",
    "asset": "brl",
    "pixKey": "string (quando target.type = pix)",
    "network": "eth | matic | trx | ton (quando target.type = crypto_wallet)",
    "address": "string (quando target.type = crypto_wallet)"
  },
  "customer": {
    "name": "string",
    "email": "string",
    "phone": "string",
    "document": "string"
  },
  "metadata": {
    "number": 1,
    "string": "yes",
    "boolean": true
  },
  "reference": "3fa85f64-5717-4562-b3fc-2c963f66afa1"
}
  • - reference é obrigatório para idempotência: requisições repetidas com a mesma referência e os mesmos parâmetros retornam a mesma conversão.
  • - customer é obrigatório nos fluxos com source = crypto_wallet.
  • - Em qualquer fluxo balance -> balance, não envie customer.

Fluxos de pipeline (4)

Saldo USDT para Pix BRL

usdt_balance_to_brl_pix

Use para converter saldo USDT interno e liquidar em BRL para uma chave Pix.

  • - Exige target.pixKey.
  • - source.asset = usdt e target.asset = brl.
  • - Não é balance->balance e não exige customer neste payload.
Request
{
  "source": {
    "type": "balance",
    "asset": "usdt",
    "amount": 35
  },
  "target": {
    "type": "pix",
    "asset": "brl",
    "pixKey": "123.456.789-09"
  },
  "reference": "c1f28f6c-2d3a-4e2d-a53c-69fca7b7f6d5"
}
Response (pending)
{
  "data": {
    "id": "01KFAKECONVERSION0000000005",
    "type": "conversion",
    "status": "pending",
    "source": {
      "type": "balance",
      "asset": "usdt",
      "amount": 35,
      "feeAmount": 1.75,
      "netAmount": 33.25
    },
    "target": {
      "type": "pix",
      "asset": "brl",
      "price": 5.325,
      "amount": 177.06,
      "pixKey": "123.456.789-09"
    },
    "reference": "c1f28f6c-2d3a-4e2d-a53c-69fca7b7f6d5",
    "createdAt": "2026-04-02T10:30:12.000Z",
    "updatedAt": "2026-04-02T10:30:12.000Z"
  },
  "success": true
}

Saldo USDT para Saldo BRL

usdt_balance_to_brl_balance

Use para rebalancear a conta internamente de USDT para BRL sem saída para Pix e sem carteira externa.

  • - Não envia customer em fluxo balance->balance.
  • - source.asset = usdt e target.asset = brl.
  • - Fluxo interno para gestão de saldo.
Request
{
  "source": {
    "type": "balance",
    "asset": "usdt",
    "amount": 35
  },
  "target": {
    "type": "balance",
    "asset": "brl"
  },
  "reference": "b7e73f85-6c24-4fb8-9de8-1b88d26d2446"
}
Response (pending)
{
  "data": {
    "id": "01KFAKECONVERSION0000000006",
    "type": "conversion",
    "status": "pending",
    "source": {
      "type": "balance",
      "asset": "usdt",
      "amount": 35,
      "feeAmount": 1.75,
      "netAmount": 33.25
    },
    "target": {
      "type": "balance",
      "asset": "brl",
      "price": 5.325,
      "amount": 177.06
    },
    "reference": "b7e73f85-6c24-4fb8-9de8-1b88d26d2446",
    "createdAt": "2026-04-02T10:34:54.000Z",
    "updatedAt": "2026-04-02T10:34:54.000Z"
  },
  "success": true
}

Carteira Cripto USDT para Pix BRL

usdt_wallet_to_brl_pix

Use quando a origem vem de carteira cripto USDT e o destino final é pagamento em BRL via Pix.

  • - source.type = crypto_wallet exige source.network.
  • - Exige target.pixKey.
  • - Requer customer completo e rastreio do endereço.
Request
{
  "source": {
    "type": "crypto_wallet",
    "asset": "usdt",
    "network": "eth",
    "amount": 35
  },
  "target": {
    "type": "pix",
    "asset": "brl",
    "pixKey": "123.456.789-09"
  },
  "customer": {
    "name": "João Silva Santos",
    "email": "[email protected]",
    "phone": "+5511987654321",
    "document": "12345678909"
  },
  "reference": "45fe2db7-3ea7-4a54-9c27-6f84411a7c28"
}
Response (pending)
{
  "data": {
    "id": "01KFAKECONVERSION0000000007",
    "type": "conversion",
    "status": "pending",
    "source": {
      "type": "crypto_wallet",
      "asset": "usdt",
      "amount": 35,
      "feeAmount": 1.75,
      "netAmount": 33.25
    },
    "target": {
      "type": "pix",
      "asset": "brl",
      "price": 5.33,
      "amount": 177.22,
      "pixKey": "123.456.789-09"
    },
    "qrCode": {
      "payload": "0xb91f30af8c0f5a92b6f47db479fe89c39163c771",
      "imageEncoded": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAJQAAACUCAYAAAB1DOCSPIZ"
    },
    "address": "0xb91f30af8c0f5a92b6f47db479fe89c39163c771",
    "reference": "45fe2db7-3ea7-4a54-9c27-6f84411a7c28",
    "createdAt": "2026-04-02T10:40:03.000Z",
    "updatedAt": "2026-04-02T10:40:03.000Z"
  },
  "success": true
}

Carteira Cripto USDT para Saldo BRL

usdt_wallet_to_brl_balance

Use quando a origem é carteira USDT e o valor convertido deve ser creditado no saldo BRL interno.

  • - source.type = crypto_wallet exige source.network.
  • - target.type = balance com asset brl.
  • - Requer customer completo.
Request
{
  "source": {
    "type": "crypto_wallet",
    "asset": "usdt",
    "network": "eth",
    "amount": 35
  },
  "target": {
    "type": "balance",
    "asset": "brl"
  },
  "customer": {
    "name": "João Silva Santos",
    "email": "[email protected]",
    "phone": "+5511987654321",
    "document": "12345678909"
  },
  "reference": "e24ab4d0-5e31-4b45-8f8a-2f7787b6fd93"
}
Response (pending)
{
  "data": {
    "id": "01KFAKECONVERSION0000000008",
    "type": "conversion",
    "status": "pending",
    "source": {
      "type": "crypto_wallet",
      "asset": "usdt",
      "amount": 35,
      "feeAmount": 1.75,
      "netAmount": 33.25
    },
    "target": {
      "type": "balance",
      "asset": "brl",
      "price": 5.325,
      "amount": 177.06
    },
    "qrCode": {
      "payload": "0x8edaf79b9f44a4d31f165a7eac688d7fe8e1145a",
      "imageEncoded": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAJQAAACUCAYAAAB1DOCSPIA"
    },
    "address": "0x8edaf79b9f44a4d31f165a7eac688d7fe8e1145a",
    "reference": "e24ab4d0-5e31-4b45-8f8a-2f7787b6fd93",
    "createdAt": "2026-04-02T10:43:37.000Z",
    "updatedAt": "2026-04-02T10:43:37.000Z"
  },
  "success": true
}