> ## Documentation Index
> Fetch the complete documentation index at: https://t3sa.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Primera llamada en 5 minutos

> De la clave de API al webhook de rescate, en el sandbox

> [!WARNING]
>
> 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.

**1. Obtenga una clave de API**

Solicite acceso en [contact@t3sa.com](mailto:contact@t3sa.com?subject=Solicitud%20de%20clave%20de%20API%20TESA). Tras la incorporación, un administrador crea la clave en el panel. Las claves de sandbox comienzan con `tesa_test_`.

```bash theme={null}
export TESA_API_KEY="tesa_test_..."
```

**2. Lea las posiciones**

```bash theme={null}
curl https://sandbox.api.t3sa.com/v1/posicoes \
  -H "Authorization: Bearer $TESA_API_KEY"
```

```json Respuesta 200 theme={null}
{
  "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"
}
```

**3. Cree un rescate**

Un rescate siempre va a una billetera vinculada de propiedad de la empresa y exige una `Idempotency-Key`.

```bash theme={null}
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`.

**4. 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.

**5. Reciba el webhook**

Registre un destino con `POST /webhooks`. Cuando la transacción se confirme on-chain, llegará este evento:

```json theme={null}
{
  "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](https://t3sa.com/docs/es/api/webhooks.md).

## Próximos pasos

> [card] [Arquitectura](https://t3sa.com/docs/es/api/arquitetura.md)
>
> Quién tiene las claves y cómo cada operación va de la preparación al registro.

> [card] [Guía de rescate](https://t3sa.com/docs/es/api/guias/resgate.md)
>
> El flujo completo de rescate, con manejo de errores.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.