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"
}
}
Webhooks
Registrar Webhook
Registra uma URL para receber notificacoes de eventos
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
string
required
URL do seu endpoint (deve ser HTTPS). Exemplo:
https://seusite.com/webhooks/thalpaystring
required
Tipo de evento para receber. Valores:
TRANSACTION, WITHDRAWAL, DISPUTE, ALLstring
Descricao do webhook. Exemplo:
Producao - ERPcurl -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"
}
}
Was this page helpful?