Webhook Dispatches - Analytics
Métricas sobre entregas de webhooks (taxas de sucesso, falhas, etc.).
Métricas sobre entregas de webhooks (taxas de sucesso, falhas, etc.).
Authorization
SelectKeyAuth API key for all authenticated requests. Send your key in the selectkey header (e.g. sandbox sl_test_…, production sl_live_…).
In: header
Query Parameters
Analytics period start
Analytics period end
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/webhooks/dispatches/analytics?initdate=2026-01-01T00%3A00%3A00Z&enddate=2026-01-31T23%3A59%3A59Z"{
"analytics": [
{
"id": "wdi_01hqzvabc",
"status": "success",
"attempts": 1,
"responseStatusCode": 200,
"lastAttemptAt": "2026-04-12T17:56:33.000Z",
"createdAt": "2026-04-12T17:56:33.000Z"
}
],
"merchant": {
"name": "Seller Name",
"merchantId": "bus_1234567890",
"isSubAccount": false
},
"_links": {
"self": {
"href": "https://api.selectwin.io/v1/webhooks/dispatches/analytics",
"method": "GET",
"description": "View analytics for webhook dispatches."
},
"list": {
"href": "https://api.selectwin.io/v1/webhooks/dispatches",
"method": "GET",
"description": "List all webhook dispatches."
}
}
}{
"error": {
"status": "Bad Request",
"statusCode": 400,
"category": "validation",
"message": "Validation errors occurred",
"details": "One or more parameters are invalid or out of range. Please check the parameters and try again.",
"params": [
{
"payment[currency]": "currency must be one of [BRL]"
},
{
"amount": "amount is required"
}
],
"code": "invalidParameters",
"resource": "client"
}
}{
"error": {
"status": "Unauthorized",
"statusCode": 401,
"category": "authentication",
"message": "Unauthorized",
"details": "Authentication failed. The provided API key is invalid or does not have permission to operate.",
"code": "unauthorized"
}
}{
"error": {
"status": "Forbidden",
"statusCode": 403,
"category": "authorization",
"message": "Forbidden",
"details": "Access denied. This may be due to IP blocks, domain restrictions, or insufficient permissions.",
"code": "forbidden"
}
}{
"error": {
"status": "Not Found",
"statusCode": 404,
"category": "client",
"message": "Not Found",
"details": "The requested resource was not found on the server.",
"code": "notFound"
}
}{
"error": {
"status": "Unprocessable Entity",
"statusCode": 422,
"category": "validation",
"message": "Unprocessable Entity",
"details": "The request was understood, but contains invalid data that could not be processed.",
"code": "unprocessableEntity"
}
}{
"error": {
"status": "Too Many Requests",
"statusCode": 429,
"category": "rate_limit",
"message": "Too Many Requests",
"details": "The number of requests exceeded the limit allowed for the IP or user.",
"retryAfterMinutes": 60,
"code": "tooManyRequests"
}
}{
"error": {
"status": "Internal Server Error",
"statusCode": 500,
"category": "server",
"message": "Server error.",
"details": "An internal server error occurred. Please try again later.",
"code": "serverError",
"resource": "server"
}
}Entrega de evento na sua URL Webhook
Corpo JSON enviado pela Selectwin quando ocorre um evento. Configure a URL em `GET/POST /v1/webhooks/endpoints`. O campo `type` segue o padrão `recurso.acao` (ex.: `transaction.approved`). **A plataforma considera entrega bem-sucedida apenas respostas HTTP `200` ou `201`** (corpo opcional). **Qualquer outro status — inclusive outros códigos 2xx, 3xx, 4xx e 5xx — é tratado como falha** e pode acionar retentativas conforme a política da plataforma.
Webhook Dispatches - List GET
Histórico de entregas de webhook: tentativas, HTTP status e diagnóstico para cada envio à sua URL.