Skip to main content
POST
/
webhooks
curl -X POST https://api.thalbank.com/webhooks \
  -H "x-api-key: sua_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://seusite.com/webhooks/thalpay",
    "eventType": "ALL",
    "description": "Producao - Sistema principal"
  }'

{
  "status": true,
  "data": {
    "id": "d4e5f6a7-b8c9-0123-def0-123456789abc",
    "url": "https://seusite.com/webhooks/thalpay",
    "eventType": "ALL",
    "description": "Producao - Sistema principal",
    "createdAt": "2026-03-10T00:00:00.000Z"
  }
}

​
Descricao

Registra um endpoint HTTPS para receber notificacoes automaticas quando transacoes, saques ou disputas mudam de status.

​
Request

​
url
string
required
URL do seu endpoint (deve ser HTTPS). Exemplo: https://seusite.com/webhooks/thalpay
​
eventType
string
required
Tipo de evento para receber. Valores: TRANSACTION, WITHDRAWAL, DISPUTE, ALL
​
description
string
Descricao do webhook. Exemplo: Producao - ERP
curl -X POST https://api.thalbank.com/webhooks \
  -H "x-api-key: sua_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://seusite.com/webhooks/thalpay",
    "eventType": "ALL",
    "description": "Producao - Sistema principal"
  }'

{
  "status": true,
  "data": {
    "id": "d4e5f6a7-b8c9-0123-def0-123456789abc",
    "url": "https://seusite.com/webhooks/thalpay",
    "eventType": "ALL",
    "description": "Producao - Sistema principal",
    "createdAt": "2026-03-10T00:00:00.000Z"
  }
}