Primera llamada en 5 minutos

Borrador: especificación en curso. Los endpoints y campos pueden cambiar.

Este recorrido usa el sandbox, sin fondos reales. Las URL son propuestas y todavía no están activas, y todos los valores son ilustrativos.

Obtenga una clave de API

Solicite acceso en contact@t3sa.com. Tras la incorporación, un administrador crea la clave en el panel. Las claves de sandbox comienzan con tesa_test_.

export TESA_API_KEY="tesa_test_..."

Lea las posiciones

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

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

Cree un rescate

Un rescate siempre va a una billetera vinculada de propiedad de la empresa y exige una 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"}'

El rescate comienza como pendente. Una clave con alcance admin, o un aprobador en el panel, lo aprueba con POST /resgates/res_4t7x/aprovar.

Firme con el custodio

Tras la aprobación, el rescate pasa a aguardando_assinatura e incluye las transacciones en transacoes[].payload_nao_assinado. Envíe ese payload al custodio de la empresa, que lo firma y lo transmite. TESA nunca ve la clave.

Reciba el webhook

Registre un destino con POST /webhooks. Cuando la transacción se confirme on-chain, llegará este 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 la firma antes de procesar. Vea Webhooks.

Próximos pasos

Arquitectura

Quién tiene las claves y cómo cada operación va de la preparación al registro.

Guía de rescate

El flujo completo de rescate, con manejo de errores.

Para comenzar

Guías

Referencia

Referencia de la API

Primera llamada en 5 minutos

Próximos pasos

Arquitectura

Guía de rescate