DELETE /v1/webhook-endpoints/2wHn5Qe8rT1yU4iO7pA3sD6fG9k HTTP/1.1
Host: api-global.fastpaybrasil.com
Authorization: Basic <base64 de "SUA_CHAVE_SECRETA:">
curl -X DELETE "https://api-global.fastpaybrasil.com/v1/webhook-endpoints/2wHn5Qe8rT1yU4iO7pA3sD6fG9k" \
-u "$FINVIA_API_KEY:"
// excluir-endpoint.mjs (Node.js 18+, ESM, await no topo)
const credentials = Buffer.from(`${process.env.FINVIA_API_KEY}:`).toString('base64');
const webhookId = '2wHn5Qe8rT1yU4iO7pA3sD6fG9k';
const response = await fetch(`https://api-global.fastpaybrasil.com/v1/webhook-endpoints/${webhookId}`, {
method: 'DELETE',
headers: { Authorization: `Basic ${credentials}` },
});
if (response.status !== 200) {
throw new Error(`Falha ao excluir: ${response.status} ${await response.text()}`);
}
console.log('Endpoint excluído');
import os
import requests
response = requests.request(
"DELETE",
"https://api-global.fastpaybrasil.com/v1/webhook-endpoints/2wHn5Qe8rT1yU4iO7pA3sD6fG9k",
auth=(os.environ["FINVIA_API_KEY"], ""),
timeout=30,
)
print(response.status_code)
if response.content:
print(response.json())
<?php
$ch = curl_init('https://api-global.fastpaybrasil.com/v1/webhook-endpoints/2wHn5Qe8rT1yU4iO7pA3sD6fG9k');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'DELETE',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_USERPWD => getenv('FINVIA_API_KEY') . ':',
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, PHP_EOL;
print_r(json_decode($body, true));
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.Base64;
public class Exemplo {
public static void main(String[] args) throws Exception {
String credentials = Base64.getEncoder()
.encodeToString((System.getenv("FINVIA_API_KEY") + ":").getBytes());
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api-global.fastpaybrasil.com/v1/webhook-endpoints/2wHn5Qe8rT1yU4iO7pA3sD6fG9k"))
.header("Authorization", "Basic " + credentials)
.method("DELETE", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
using System.Net.Http.Headers;
using System.Text;
var apiKey = Environment.GetEnvironmentVariable("FINVIA_API_KEY");
var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($"{apiKey}:"));
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic", credentials);
var request = new HttpRequestMessage(HttpMethod.Delete, "https://api-global.fastpaybrasil.com/v1/webhook-endpoints/2wHn5Qe8rT1yU4iO7pA3sD6fG9k");
var response = await client.SendAsync(request);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());
package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest("DELETE", "https://api-global.fastpaybrasil.com/v1/webhook-endpoints/2wHn5Qe8rT1yU4iO7pA3sD6fG9k", nil)
if err != nil {
panic(err)
}
req.SetBasicAuth(os.Getenv("FINVIA_API_KEY"), "")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(res.StatusCode)
fmt.Println(string(body))
}
require "net/http"
require "uri"
uri = URI("https://api-global.fastpaybrasil.com/v1/webhook-endpoints/2wHn5Qe8rT1yU4iO7pA3sD6fG9k")
request = Net::HTTP::Delete.new(uri)
request.basic_auth(ENV.fetch("FINVIA_API_KEY"), "")
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts response.code
puts response.body
(sem corpo)
{
"statusCode": 404,
"message": "Webhook não encontrado",
"error": "Not Found"
}
Webhooks
Excluir endpoint de webhook
Remove um endpoint de webhook, e a URL deixa de receber os eventos da conta.
DELETE
/
v1
/
webhook-endpoints
/
{webhookId}
DELETE /v1/webhook-endpoints/2wHn5Qe8rT1yU4iO7pA3sD6fG9k HTTP/1.1
Host: api-global.fastpaybrasil.com
Authorization: Basic <base64 de "SUA_CHAVE_SECRETA:">
curl -X DELETE "https://api-global.fastpaybrasil.com/v1/webhook-endpoints/2wHn5Qe8rT1yU4iO7pA3sD6fG9k" \
-u "$FINVIA_API_KEY:"
// excluir-endpoint.mjs (Node.js 18+, ESM, await no topo)
const credentials = Buffer.from(`${process.env.FINVIA_API_KEY}:`).toString('base64');
const webhookId = '2wHn5Qe8rT1yU4iO7pA3sD6fG9k';
const response = await fetch(`https://api-global.fastpaybrasil.com/v1/webhook-endpoints/${webhookId}`, {
method: 'DELETE',
headers: { Authorization: `Basic ${credentials}` },
});
if (response.status !== 200) {
throw new Error(`Falha ao excluir: ${response.status} ${await response.text()}`);
}
console.log('Endpoint excluído');
import os
import requests
response = requests.request(
"DELETE",
"https://api-global.fastpaybrasil.com/v1/webhook-endpoints/2wHn5Qe8rT1yU4iO7pA3sD6fG9k",
auth=(os.environ["FINVIA_API_KEY"], ""),
timeout=30,
)
print(response.status_code)
if response.content:
print(response.json())
<?php
$ch = curl_init('https://api-global.fastpaybrasil.com/v1/webhook-endpoints/2wHn5Qe8rT1yU4iO7pA3sD6fG9k');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'DELETE',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_USERPWD => getenv('FINVIA_API_KEY') . ':',
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, PHP_EOL;
print_r(json_decode($body, true));
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.Base64;
public class Exemplo {
public static void main(String[] args) throws Exception {
String credentials = Base64.getEncoder()
.encodeToString((System.getenv("FINVIA_API_KEY") + ":").getBytes());
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api-global.fastpaybrasil.com/v1/webhook-endpoints/2wHn5Qe8rT1yU4iO7pA3sD6fG9k"))
.header("Authorization", "Basic " + credentials)
.method("DELETE", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
using System.Net.Http.Headers;
using System.Text;
var apiKey = Environment.GetEnvironmentVariable("FINVIA_API_KEY");
var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($"{apiKey}:"));
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic", credentials);
var request = new HttpRequestMessage(HttpMethod.Delete, "https://api-global.fastpaybrasil.com/v1/webhook-endpoints/2wHn5Qe8rT1yU4iO7pA3sD6fG9k");
var response = await client.SendAsync(request);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());
package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest("DELETE", "https://api-global.fastpaybrasil.com/v1/webhook-endpoints/2wHn5Qe8rT1yU4iO7pA3sD6fG9k", nil)
if err != nil {
panic(err)
}
req.SetBasicAuth(os.Getenv("FINVIA_API_KEY"), "")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(res.StatusCode)
fmt.Println(string(body))
}
require "net/http"
require "uri"
uri = URI("https://api-global.fastpaybrasil.com/v1/webhook-endpoints/2wHn5Qe8rT1yU4iO7pA3sD6fG9k")
request = Net::HTTP::Delete.new(uri)
request.basic_auth(ENV.fetch("FINVIA_API_KEY"), "")
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts response.code
puts response.body
(sem corpo)
{
"statusCode": 404,
"message": "Webhook não encontrado",
"error": "Not Found"
}
Esta rota exclui um endpoint de webhook. Depois da exclusão, a URL deixa de receber os eventos de cobrança, assinatura e saque daquela conta. Não existe opção de desativar um endpoint temporariamente: para parar de receber, exclua; para voltar a receber, cadastre de novo.
Trate o erro pelo código HTTP, não pelo texto da mensagem.
Quando usar
| Situação | Como usar esta rota |
|---|---|
| Desligar um servidor antigo depois de uma migração | Cadastre o novo endpoint, confirme o recebimento e exclua o antigo |
| Remover um cadastro duplicado (mesma URL em dois endpoints) | Exclua um deles |
A master passou a usar include_submerchants e não precisa mais dos endpoints de cada subconta | Exclua os endpoints das subcontas |
Eventos enviados depois da exclusão não chegam a essa URL. Antes de excluir o único endpoint de uma conta, garanta que outro destino está recebendo os eventos, ou que a sua aplicação vai acompanhar as cobranças pela API.
Antes de chamar
- Use a chave secreta (
sk_) em Basic (Credenciais e ambientes). A chave age com as permissões do usuário que a gerou: um perfil sem permissão de webhooks recebe403Acesso negado. - Tenha o
iddo endpoint, obtido emGET /v1/webhook-endpoints.
Parâmetros de caminho
Respostas
A resposta de sucesso é200 sem corpo.
| HTTP | Significado | Corpo |
|---|---|---|
200 | Endpoint excluído | Sem corpo |
401 | Credencial inválida | {"statusCode": 401, "message": "Unauthorized"} |
403 | Endpoint de conta sem acesso ou perfil de usuário sem permissão de webhooks | { statusCode, message, error } com message Acesso negado |
404 | Endpoint não encontrado | { statusCode, message, error } com message Webhook não encontrado |
Erros comuns
| Sintoma | Causa | Como resolver |
|---|---|---|
404 Webhook não encontrado | Id errado ou endpoint já excluído | Liste os endpoints e confira o id |
403 Acesso negado | O endpoint é de uma conta a que a credencial não tem acesso, ou o perfil do usuário não tem permissão de webhooks | Use uma chave da conta dona do endpoint (ou da master que criou a subconta) gerada por um usuário com permissão |
| Eventos continuam chegando na URL | Outro endpoint com a mesma URL, endpoint da master com include_submerchants: true ou a URL também usada como postbackUrl das cobranças | Liste os endpoints da conta e da master e revise o postbackUrl enviado nas cobranças |
DELETE /v1/webhook-endpoints/2wHn5Qe8rT1yU4iO7pA3sD6fG9k HTTP/1.1
Host: api-global.fastpaybrasil.com
Authorization: Basic <base64 de "SUA_CHAVE_SECRETA:">
curl -X DELETE "https://api-global.fastpaybrasil.com/v1/webhook-endpoints/2wHn5Qe8rT1yU4iO7pA3sD6fG9k" \
-u "$FINVIA_API_KEY:"
// excluir-endpoint.mjs (Node.js 18+, ESM, await no topo)
const credentials = Buffer.from(`${process.env.FINVIA_API_KEY}:`).toString('base64');
const webhookId = '2wHn5Qe8rT1yU4iO7pA3sD6fG9k';
const response = await fetch(`https://api-global.fastpaybrasil.com/v1/webhook-endpoints/${webhookId}`, {
method: 'DELETE',
headers: { Authorization: `Basic ${credentials}` },
});
if (response.status !== 200) {
throw new Error(`Falha ao excluir: ${response.status} ${await response.text()}`);
}
console.log('Endpoint excluído');
import os
import requests
response = requests.request(
"DELETE",
"https://api-global.fastpaybrasil.com/v1/webhook-endpoints/2wHn5Qe8rT1yU4iO7pA3sD6fG9k",
auth=(os.environ["FINVIA_API_KEY"], ""),
timeout=30,
)
print(response.status_code)
if response.content:
print(response.json())
<?php
$ch = curl_init('https://api-global.fastpaybrasil.com/v1/webhook-endpoints/2wHn5Qe8rT1yU4iO7pA3sD6fG9k');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'DELETE',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_USERPWD => getenv('FINVIA_API_KEY') . ':',
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, PHP_EOL;
print_r(json_decode($body, true));
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.Base64;
public class Exemplo {
public static void main(String[] args) throws Exception {
String credentials = Base64.getEncoder()
.encodeToString((System.getenv("FINVIA_API_KEY") + ":").getBytes());
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api-global.fastpaybrasil.com/v1/webhook-endpoints/2wHn5Qe8rT1yU4iO7pA3sD6fG9k"))
.header("Authorization", "Basic " + credentials)
.method("DELETE", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
using System.Net.Http.Headers;
using System.Text;
var apiKey = Environment.GetEnvironmentVariable("FINVIA_API_KEY");
var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($"{apiKey}:"));
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic", credentials);
var request = new HttpRequestMessage(HttpMethod.Delete, "https://api-global.fastpaybrasil.com/v1/webhook-endpoints/2wHn5Qe8rT1yU4iO7pA3sD6fG9k");
var response = await client.SendAsync(request);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());
package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest("DELETE", "https://api-global.fastpaybrasil.com/v1/webhook-endpoints/2wHn5Qe8rT1yU4iO7pA3sD6fG9k", nil)
if err != nil {
panic(err)
}
req.SetBasicAuth(os.Getenv("FINVIA_API_KEY"), "")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(res.StatusCode)
fmt.Println(string(body))
}
require "net/http"
require "uri"
uri = URI("https://api-global.fastpaybrasil.com/v1/webhook-endpoints/2wHn5Qe8rT1yU4iO7pA3sD6fG9k")
request = Net::HTTP::Delete.new(uri)
request.basic_auth(ENV.fetch("FINVIA_API_KEY"), "")
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts response.code
puts response.body
(sem corpo)
{
"statusCode": 404,
"message": "Webhook não encontrado",
"error": "Not Found"
}
Veja também
Listar endpoints
Obtenha o id do endpoint.
Criar endpoint
Cadastre um novo destino.
Atualizar endpoint
Troque a URL sem excluir.
Webhooks: visão geral
Destinos, formatos e deduplicação.

