Disable Payment Destination
curl --request POST \
--url https://api.hopnow.io/ads/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payment-destinations/{id}/disable \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hopnow.io/ads/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payment-destinations/{id}/disable"
headers = {"X-API-Key": "<api-key>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.hopnow.io/ads/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payment-destinations/{id}/disable', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.hopnow.io/ads/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payment-destinations/{id}/disable",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
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;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.hopnow.io/ads/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payment-destinations/{id}/disable"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.hopnow.io/ads/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payment-destinations/{id}/disable")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hopnow.io/ads/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payment-destinations/{id}/disable")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"object": "payment_destination",
"id": "dest_8kpw2x7a3b9c1e5f2d4g6h8j",
"beneficiary_id": "bene_5tql9z7a3b9c1e5f2d4g6h8j",
"country": "GB",
"type": "bank_account",
"currency": "GBP",
"status": "disabled",
"account_number_last4": "****6819",
"iban_masked": "GB29****6819",
"is_default": false,
"created": "2026-05-01T10:05:00Z",
"updated": "2026-05-15T11:20:00Z",
"created_by": "ak_x7k2m9p4q1w8e5r3t6y0u2i4",
"updated_by": "ak_x7k2m9p4q1w8e5r3t6y0u2i4"
}
Payment Destinations
Disable Payment Destination
Disable a payment destination so no future payments can be sent to it
POST
/
ads
/
v1
/
accounts
/
{account_id}
/
beneficiaries
/
{beneficiary_id}
/
payment-destinations
/
{id}
/
disable
Disable Payment Destination
curl --request POST \
--url https://api.hopnow.io/ads/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payment-destinations/{id}/disable \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hopnow.io/ads/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payment-destinations/{id}/disable"
headers = {"X-API-Key": "<api-key>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.hopnow.io/ads/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payment-destinations/{id}/disable', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.hopnow.io/ads/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payment-destinations/{id}/disable",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
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;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.hopnow.io/ads/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payment-destinations/{id}/disable"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.hopnow.io/ads/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payment-destinations/{id}/disable")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hopnow.io/ads/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payment-destinations/{id}/disable")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"object": "payment_destination",
"id": "dest_8kpw2x7a3b9c1e5f2d4g6h8j",
"beneficiary_id": "bene_5tql9z7a3b9c1e5f2d4g6h8j",
"country": "GB",
"type": "bank_account",
"currency": "GBP",
"status": "disabled",
"account_number_last4": "****6819",
"iban_masked": "GB29****6819",
"is_default": false,
"created": "2026-05-01T10:05:00Z",
"updated": "2026-05-15T11:20:00Z",
"created_by": "ak_x7k2m9p4q1w8e5r3t6y0u2i4",
"updated_by": "ak_x7k2m9p4q1w8e5r3t6y0u2i4"
}
Disables a payment destination so that no future payments can be sent to it. Takes the path
id with an empty body.
Path Parameters
string
required
Id of the parent account (e.g.
acct_...).string
required
Id of the parent beneficiary (e.g.
bene_...).string
required
Destination id (e.g.
dest_…).Response
Returns thepayment_destination object with status = disabled.
{
"object": "payment_destination",
"id": "dest_8kpw2x7a3b9c1e5f2d4g6h8j",
"beneficiary_id": "bene_5tql9z7a3b9c1e5f2d4g6h8j",
"country": "GB",
"type": "bank_account",
"currency": "GBP",
"status": "disabled",
"account_number_last4": "****6819",
"iban_masked": "GB29****6819",
"is_default": false,
"created": "2026-05-01T10:05:00Z",
"updated": "2026-05-15T11:20:00Z",
"created_by": "ak_x7k2m9p4q1w8e5r3t6y0u2i4",
"updated_by": "ak_x7k2m9p4q1w8e5r3t6y0u2i4"
}
⌘I