First call in 5 minutes

Draft: specification in progress. Endpoints and fields may change.

This walkthrough uses the sandbox, with no real funds. The URLs are proposals and are not live yet, and all values are illustrative.

Get an API key

Request access at contact@t3sa.com. After onboarding, an administrator creates the key in the dashboard. Sandbox keys start with tesa_test_.

export TESA_API_KEY="tesa_test_..."

Read positions

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

Response 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"
}

Create a redemption

A redemption always goes to a linked wallet owned by the company and requires an 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"}'

The redemption starts as pendente. A key with admin scope, or an approver in the dashboard, approves it with POST /resgates/res_4t7x/aprovar.

Sign with the custodian

After approval, the redemption moves to aguardando_assinatura and includes the transactions in transacoes[].payload_nao_assinado. Send that payload to the company’s custodian, which signs and broadcasts it. TESA never sees the key.

Receive the webhook

{
  "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" }
}

Verify the signature before processing. See Webhooks.

Next steps

Architecture

Who holds the keys and how each operation moves from preparation to record.

Redemption guide

The complete redemption flow, with error handling.

Getting started

Guides

Reference

API reference

First call in 5 minutes

Next steps

Architecture

Redemption guide

​Next steps

Architecture

Redemption guide

Next steps