API reference / Webhooks

Remove your webhook URL

DELETE/v1/webhook-endpoint

Stops this mode's webhooks until a URL is set again.

Removes url and withdrawals_url. Only payments and checkouts created with a webhook_url still get webhooks, until you set a URL again.

Headers

AuthorizationstringRequired
Bearer plus your API key. See Authentication.

Responses

200 OK

Removed (code 2000000). The withdrawals URL, if set, is removed too.

What data holds

webhook_endpointany | null

401 Unauthorized

Missing, malformed or unknown API key (code 4010000).

403 Forbidden

The key can't make this request (code 4030000): an address outside the key's IP allowlist, a live key before your live mode is on, or an account that isn't active. A live key sent from a browser is refused (code 4030001): keep live keys on your server.

404 Not Found

Not found in this mode for your account (code 4040000).

curl -X DELETE https://api.weavpayments.com/v1/webhook-endpoint \
    -H "Authorization: Bearer $WEAV_API_KEY"

const url = 'https://api.weavpayments.com/v1/webhook-endpoint';
const response = await fetch(url, {
    method: 'DELETE',
    headers: {
        Authorization: `Bearer ${process.env.WEAV_API_KEY}`,
    },
});

const result = await response.json();

import axios from 'axios';

const response = await axios.request({
    method: 'delete',
    url: 'https://api.weavpayments.com/v1/webhook-endpoint',
    headers: {
        Authorization: `Bearer ${process.env.WEAV_API_KEY}`,
    },
    // Read error answers too: their body has the error code.
    validateStatus: () => true,
});

const result = response.data;

use Illuminate\Support\Facades\Http;

$response = Http::withToken(config('services.weav.key'))
    ->delete('https://api.weavpayments.com/v1/webhook-endpoint');

$result = $response->json();

import os
import requests

response = requests.delete(
    "https://api.weavpayments.com/v1/webhook-endpoint",
    headers={
        "Authorization": f"Bearer {os.environ['WEAV_API_KEY']}",
    },
    timeout=30,
)

result = response.json()

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
)

func main() {
    req, err := http.NewRequest("DELETE", "https://api.weavpayments.com/v1/webhook-endpoint", nil)
    if err != nil {
        panic(err)
    }
    req.Header.Set("Authorization", "Bearer "+os.Getenv("WEAV_API_KEY"))

    res, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer res.Body.Close()

    result, err := io.ReadAll(res.Body)
    if err != nil {
        panic(err)
    }
    fmt.Println(res.Status, string(result))
}

// Cargo.toml: reqwest = { version = "0.12", features = ["blocking", "json"] }, serde_json = "1"
fn main() -> Result<(), Box<dyn std::error::Error>> {
    let key = std::env::var("WEAV_API_KEY")?;

    let response = reqwest::blocking::Client::new()
        .delete("https://api.weavpayments.com/v1/webhook-endpoint")
        .bearer_auth(key)
        .send()?;

    let status = response.status();
    let result: serde_json::Value = response.json()?;
    println!("{status} {result:#}");
    Ok(())
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class WeavExample {
    public static void main(String[] args) throws Exception {
        String url = "https://api.weavpayments.com/v1/webhook-endpoint";
        HttpRequest request =
                HttpRequest.newBuilder()
                        .uri(URI.create(url))
                        .header("Authorization", "Bearer " + System.getenv("WEAV_API_KEY"))
                        .DELETE()
                        .build();

        HttpResponse<String> response =
                HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode() + " " + response.body());
    }
}

{
    "code": "2000000",
    "success": true,
    "message": "Webhook endpoint removed",
    "data": {
        "webhook_endpoint": null
    }
}

{
    "code": "4010000",
    "success": false,
    "message": "Missing or invalid API key."
}

{
    "code": "4030000",
    "success": false,
    "message": "Requests with this key must come from an address on its allowlist."
}

{
    "code": "4040000",
    "success": false,
    "message": "Not found."
}