curl --request GET \
--url https://api.alphagateway.com.br/v1/webhook-deliveries \
--header 'x-api-key: <api-key>'const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.alphagateway.com.br/v1/webhook-deliveries', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.alphagateway.com.br/v1/webhook-deliveries"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.alphagateway.com.br/v1/webhook-deliveries",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"message": "Entregas de webhook listadas com sucesso",
"response": {
"deliveries": [
{
"id": "01961234-abcd-7000-8000-0000000000f1",
"event": "PIX_IN_PAYED",
"eventName": "pix_in.paid",
"status": "FAILED",
"endpointId": "01961234-abcd-7000-8000-0000000000e1",
"url": "https://meusis*********.br/we*********pha",
"transactionId": "01961234-abcd-7000-8000-000000000001",
"attempts": 5,
"maxAttempts": 5,
"lastError": "O endpoint respondeu HTTP 500",
"nextRetryAt": null,
"lastAttemptAt": "2026-10-22T15:05:12.000Z",
"completedAt": "2026-10-22T15:05:12.000Z",
"createdAt": "2026-10-22T13:05:12.000Z",
"payload": null
}
],
"page": 1,
"limit": 20,
"hasMore": false
}
}{
"response": null,
"errors": [
"O valor da transação deve ser maior ou igual a R$1,00"
]
}{
"response": null,
"errors": [
"API key inválida ou expirada"
]
}{
"response": null,
"errors": [
"Credencial não possui permissão para esta funcionalidade, ajuste o escopo da credencial."
]
}{
"response": null,
"errors": [
"Limite de requisições excedido"
]
}{
"response": null,
"errors": [
"Erro interno"
]
}{
"response": null,
"errors": [
"Este serviço está temporariamente indisponível devido a manutenção"
]
}Listar entregas de webhook
Lista as notificações de webhook enviadas (ou a enviar) para a organização, da mais recente para a mais antiga, com status e tentativas; o corpo enviado (payload) vem só com includePayload=true. O período tem no máximo 7 dias (sem datas, as últimas 24 horas) e a página vai até 100. Para as entregas de uma cobrança ou saque, filtre pelo transactionId retornado na consulta da operação.
curl --request GET \
--url https://api.alphagateway.com.br/v1/webhook-deliveries \
--header 'x-api-key: <api-key>'const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.alphagateway.com.br/v1/webhook-deliveries', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.alphagateway.com.br/v1/webhook-deliveries"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.alphagateway.com.br/v1/webhook-deliveries",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"message": "Entregas de webhook listadas com sucesso",
"response": {
"deliveries": [
{
"id": "01961234-abcd-7000-8000-0000000000f1",
"event": "PIX_IN_PAYED",
"eventName": "pix_in.paid",
"status": "FAILED",
"endpointId": "01961234-abcd-7000-8000-0000000000e1",
"url": "https://meusis*********.br/we*********pha",
"transactionId": "01961234-abcd-7000-8000-000000000001",
"attempts": 5,
"maxAttempts": 5,
"lastError": "O endpoint respondeu HTTP 500",
"nextRetryAt": null,
"lastAttemptAt": "2026-10-22T15:05:12.000Z",
"completedAt": "2026-10-22T15:05:12.000Z",
"createdAt": "2026-10-22T13:05:12.000Z",
"payload": null
}
],
"page": 1,
"limit": 20,
"hasMore": false
}
}{
"response": null,
"errors": [
"O valor da transação deve ser maior ou igual a R$1,00"
]
}{
"response": null,
"errors": [
"API key inválida ou expirada"
]
}{
"response": null,
"errors": [
"Credencial não possui permissão para esta funcionalidade, ajuste o escopo da credencial."
]
}{
"response": null,
"errors": [
"Limite de requisições excedido"
]
}{
"response": null,
"errors": [
"Erro interno"
]
}{
"response": null,
"errors": [
"Este serviço está temporariamente indisponível devido a manutenção"
]
}Autorizações
API Key da organização
Parâmetros de consulta
Início do período: data e hora ISO 8601 com fuso (ex.: 2026-11-02T00:00:00-03:00). Padrão: 24 horas antes de endDate. Período máximo de 7 dias.
Fim do período: data e hora ISO 8601 com fuso. Padrão: agora.
Filtra pelo status da entrega: PENDING (na fila), PROCESSING (enviando), SUCCESS (entregue) ou FAILED (tentativas esgotadas).
PENDING, PROCESSING, SUCCESS, FAILED Evento assinado (valor de value em GET /v1/webhook-event-types, ex.: PIX_IN_PAYED).
PIX_IN_PAYED, PIX_IN_REFUNDED, PIX_OUT_ANALYSIS, PIX_OUT_PAID, PIX_OUT_REJECTED, PIX_OUT_ERROR, PIX_OUT_REFUNDED, CHECKOUT_PAID, CHECKOUT_CANCELED, CHECKOUT_REJECTED, CHECKOUT_REFUNDED, INVOICE_INSTALLMENT_PAID, INVOICE_INSTALLMENT_CHARGE_FAILED, INVOICE_INSTALLMENT_OVERDUE, INVOICE_FULLY_PAID, INFRACTION_OPENED, INFRACTION_RESOLVED, BOLETO_CREATED, BOLETO_PAID, BOLETO_CANCELED, BOLETO_REFUNDED Filtra pelas notificações de uma transação (transactionId retornado nas consultas de cobrança, boleto e saque e no payload).
true para incluir o corpo JSON enviado em cada entrega (payload). Padrão: false.
true, false Página desejada, de 1 a 100.
1 <= x <= 100Itens por página (1 a 50).
1 <= x <= 50