Primeira chamada em 5 minutos

Rascunho: especificação em definição. Endpoints e campos podem mudar.

Este roteiro usa o sandbox, sem fundos reais. As URLs são propostas e ainda não estão ativas, e todos os valores são ilustrativos.

Obtenha uma chave de API

Solicite acesso em contact@t3sa.com. Depois do onboarding, um administrador cria a chave no painel. Chaves de sandbox começam com tesa_test_.

export TESA_API_KEY="tesa_test_..."

Leia as posições

curl https://sandbox.api.t3sa.com/v1/posicoes \
  -H "Authorization: Bearer $TESA_API_KEY"

Resposta 200

{
  "total": "1284530.00",
  "rendendo": "842110.00",
  "disponivel": "442420.00",
  "por_ativo": [
    { "ativo": "USDY", "valor": "505266.00", "percentual": 60.00 },
    { "ativo": "BUIDL", "valor": "336844.00", "percentual": 40.00 }
  ],
  "yield_acumulado": "18432.55",
  "atualizado_em": "2026-09-01T12:00:00Z"
}

Crie um resgate

O resgate vai sempre para uma carteira vinculada da própria empresa e exige Idempotency-Key.

curl -X POST https://sandbox.api.t3sa.com/v1/resgates \
  -H "Authorization: Bearer $TESA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"valor":"150000.00","carteira_destino_id":"cart_3k9d","referencia_interna":"folha-2026-09"}'

O resgate nasce pendente. Uma chave com escopo admin, ou um aprovador no painel, aprova com POST /resgates/res_4t7x/aprovar.

Assine no custodiante

Depois da aprovação, o resgate passa a aguardando_assinatura e traz as transações em transacoes[].payload_nao_assinado. Envie esse payload ao custodiante da empresa, que assina e transmite. A TESA nunca vê a chave.

Receba o webhook

Cadastre um destino com POST /webhooks. Quando a transação confirma on-chain, chega o evento:

{
  "id": "evt_9k2m4p",
  "tipo": "resgate.concluido",
  "criado_em": "2026-09-01T14:07:12Z",
  "ambiente": "sandbox",
  "organizacao_id": "org_1a2b",
  "dados": { "id": "res_4t7x", "status": "concluido", "valor": "150000.00" }
}

Verifique a assinatura antes de processar. Veja Webhooks.

Próximos passos

Arquitetura

Quem guarda as chaves e como cada operação passa do preparo ao registro.

Guia de resgate

O fluxo de resgate completo, com tratamento de erros.

Começando

Guias

Referência

Referência da API

Primeira chamada em 5 minutos

Próximos passos

Arquitetura

Guia de resgate

​Próximos passos

Arquitetura

Guia de resgate

Próximos passos