←Trocar docs

Docs/Conversões

Conversões

Execute fluxos com source.asset=brl para conversão em USDT 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 | pix

target.type

balance | crypto_wallet

asset

brl | usdt

network (crypto)

eth | matic | trx | ton

Schema base do request
{
  "source": {
    "type": "balance | pix",
    "asset": "brl",
    "amount": "number",
    "network": "eth | matic | trx | ton (quando source.type = crypto_wallet)"
  },
  "target": {
    "type": "balance | crypto_wallet",
    "asset": "usdt",
    "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 = pix.
  • - Em qualquer fluxo balance -> balance, não envie customer.

Fluxos de pipeline (4)

Saldo BRL para Saldo USDT

brl_balance_to_usdt_balance

Use quando você já possui BRL em saldo interno e deseja converter para USDT dentro da conta, sem gerar cobrança Pix e sem saída para carteira externa.

  • - Não envia customer em fluxo balance->balance.
  • - source.asset = brl e target.asset = usdt.
  • - Indicado para tesouraria e rebalanceamento interno.
Request
{
  "source": {
    "type": "balance",
    "asset": "brl",
    "amount": 250
  },
  "target": {
    "type": "balance",
    "asset": "usdt"
  },
  "reference": "3fa85f64-5717-4562-b3fc-2c963f66afa1"
}
Response (pending)
{
  "data": {
    "id": "01KFAKECONVERSION0000000001",
    "type": "conversion",
    "status": "pending",
    "source": {
      "type": "balance",
      "asset": "brl",
      "amount": 250,
      "feeAmount": 6.25,
      "netAmount": 243.75
    },
    "target": {
      "type": "balance",
      "asset": "usdt",
      "amount": 45.475746,
      "price": 5.36
    },
    "reference": "3fa85f64-5717-4562-b3fc-2c963f66afa1",
    "createdAt": "2026-04-02T10:11:45.000Z",
    "updatedAt": "2026-04-02T10:11:45.000Z"
  },
  "success": true
}

Saldo BRL para Carteira Cripto USDT

brl_balance_to_usdt_wallet

Use quando o valor já está em saldo BRL e o destino final precisa ser uma carteira cripto USDT em rede suportada.

  • - Exige target.network e target.address.
  • - Inclua customer para trilha de compliance.
  • - source.asset = brl e target.asset = usdt.
Request
{
  "source": {
    "type": "balance",
    "asset": "brl",
    "amount": 250
  },
  "target": {
    "type": "crypto_wallet",
    "asset": "usdt",
    "network": "eth",
    "address": "0x1aa02f44f0f7f9d8cd4b4f4af4cc53e16bb2f911"
  },
  "customer": {
    "name": "João Silva Santos",
    "email": "joao.silva@example.com",
    "phone": "+5511987654321",
    "document": "12345678909"
  },
  "reference": "6d4b17a3-2ec0-4f54-8d71-512c7de6c2c2"
}
Response (pending)
{
  "data": {
    "id": "01KFAKECONVERSION0000000002",
    "type": "conversion",
    "status": "pending",
    "source": {
      "type": "balance",
      "asset": "brl",
      "amount": 250,
      "feeAmount": 6.25,
      "netAmount": 243.75
    },
    "target": {
      "type": "crypto_wallet",
      "asset": "usdt",
      "amount": 45.475746,
      "price": 5.36,
      "network": "eth",
      "address": "0x1aa02f44f0f7f9d8cd4b4f4af4cc53e16bb2f911"
    },
    "reference": "6d4b17a3-2ec0-4f54-8d71-512c7de6c2c2",
    "createdAt": "2026-04-02T10:17:21.000Z",
    "updatedAt": "2026-04-02T10:17:21.000Z"
  },
  "success": true
}

Pix BRL para Saldo USDT

brl_pix_to_usdt_balance

Use quando o cliente paga via Pix e você quer creditar o valor convertido diretamente no saldo USDT da empresa.

  • - Gera qrCode para pagamento.
  • - Requer customer completo.
  • - source.type = pix e source.asset = brl.
Request
{
  "source": {
    "type": "pix",
    "asset": "brl",
    "amount": 250
  },
  "target": {
    "type": "balance",
    "asset": "usdt"
  },
  "customer": {
    "name": "João Silva Santos",
    "email": "joao.silva@example.com",
    "phone": "+5511987654321",
    "document": "12345678909"
  },
  "reference": "9a8e45f2-c2df-49fd-9d7e-9e1d8bc44733"
}
Response (pending)
{
  "data": {
    "id": "01KFAKECONVERSION0000000003",
    "type": "conversion",
    "status": "pending",
    "source": {
      "type": "pix",
      "asset": "brl",
      "amount": 250,
      "feeAmount": 6.25,
      "netAmount": 243.75
    },
    "target": {
      "type": "balance",
      "asset": "usdt",
      "amount": 45.475746,
      "price": 5.36
    },
    "reference": "9a8e45f2-c2df-49fd-9d7e-9e1d8bc44733",
    "createdAt": "2026-04-02T10:20:08.000Z",
    "updatedAt": "2026-04-02T10:20:08.000Z",
    "qrCode": {
      "payload": "00020126580014br.gov.bcb.pix0136aurepay-docs-conv-00035204000053039865802BR5920Joao Silva Santos6009Sao_Paulo62070503***6304A1B2",
      "imageEncoded": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOQAAADkCAYAAAB1DOCSPIX"
    }
  },
  "success": true
}

Pix BRL para Carteira Cripto USDT

brl_pix_to_usdt_wallet

Use quando o cliente paga em Pix e o destino final deve ser envio de USDT para uma carteira cripto.

  • - Gera qrCode para a etapa de pagamento Pix.
  • - Exige target.network e target.address.
  • - Requer customer completo.
Request
{
  "source": {
    "type": "pix",
    "asset": "brl",
    "amount": 250
  },
  "target": {
    "type": "crypto_wallet",
    "asset": "usdt",
    "network": "eth",
    "address": "0x1aa02f44f0f7f9d8cd4b4f4af4cc53e16bb2f911"
  },
  "customer": {
    "name": "João Silva Santos",
    "email": "joao.silva@example.com",
    "phone": "+5511987654321",
    "document": "12345678909"
  },
  "reference": "28dcb4a8-9077-4f54-9a8b-9f86bc46d904"
}
Response (pending)
{
  "data": {
    "id": "01KFAKECONVERSION0000000004",
    "type": "conversion",
    "status": "pending",
    "source": {
      "type": "pix",
      "asset": "brl",
      "amount": 250,
      "feeAmount": 6.25,
      "netAmount": 243.75
    },
    "target": {
      "type": "crypto_wallet",
      "asset": "usdt",
      "amount": 45.475746,
      "price": 5.36,
      "network": "eth",
      "address": "0x1aa02f44f0f7f9d8cd4b4f4af4cc53e16bb2f911"
    },
    "reference": "28dcb4a8-9077-4f54-9a8b-9f86bc46d904",
    "createdAt": "2026-04-02T10:22:36.000Z",
    "updatedAt": "2026-04-02T10:22:36.000Z",
    "qrCode": {
      "payload": "00020126580014br.gov.bcb.pix0136aurepay-docs-conv-00045204000053039865802BR5920Joao Silva Santos6009Sao_Paulo62070503***6304C3D4",
      "imageEncoded": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOQAAADkCAYAAAB1DOCSPIY"
    }
  },
  "success": true
}