Saltar al contenido principal
POST
Registrar destino de webhook
Borrador: especificación en curso. Los endpoints y campos pueden cambiar.

Autorizaciones

Authorization
string
header
requerido

La clave de API de la organización (tesa_live_... en producción, tesa_test_... en el sandbox).

Encabezados

Idempotency-Key
string<uuid>

Valor único generado por la integración. Repetir la clave con el mismo cuerpo devuelve la respuesta original.

Cuerpo

application/json
url
string<uri>
requerido
eventos
enum<string>[]
Opciones disponibles:
deposito.confirmado,
alocacao.proposta,
alocacao.aprovada,
resgate.concluido,
rendimento.apurado,
fatura.emitida

Respuesta

Destino registrado.

id
string
Ejemplo:

"wh_6r3n"

url
string<uri>
eventos
enum<string>[]

Una lista vacía suscribe a todos los eventos.

Opciones disponibles:
deposito.confirmado,
alocacao.proposta,
alocacao.aprovada,
resgate.concluido,
rendimento.apurado,
fatura.emitida
status
enum<string>
Opciones disponibles:
ativo,
pausado
criado_em
string<date-time>
segredo
string

El secreto HMAC del destino. Se muestra solo en la creación.

Ejemplo:

"whsec_..."