Cancel a Subscription

Cancellation prevents future scheduled charges and clears the subscription’s next billing date. It does not refund charges that have already completed.

Both cancellation endpoints below are public and perform the same operation.

Dedicated Cancel Endpoint

POST https://backendapi.sayswitchgroup.com/api/v1/subscription/{id_or_code}/cancel

curl --request POST \
  --url https://backendapi.sayswitchgroup.com/api/v1/subscription/SUB_7q2m9x4k1v8b5n3p6r0s/cancel \
  --header "Authorization: Bearer YOUR_SECRET_KEY" \
  --header "Accept: application/json"

// Run secret-key requests on your server.
const response = await fetch("https://backendapi.sayswitchgroup.com/api/v1/subscription/SUB_7q2m9x4k1v8b5n3p6r0s/cancel", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_SECRET_KEY",
    "Accept": "application/json"
  }
});
 
const responseBody = await response.text();
console.log(response.status, responseBody);

<?php
$request = curl_init('https://backendapi.sayswitchgroup.com/api/v1/subscription/SUB_7q2m9x4k1v8b5n3p6r0s/cancel');
 
curl_setopt_array($request, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_SECRET_KEY',
        'Accept: application/json',
    ],
]);
 
$responseBody = curl_exec($request);
$status = curl_getinfo($request, CURLINFO_HTTP_CODE);
curl_close($request);
 
echo $status . PHP_EOL;
echo $responseBody;

from urllib.request import Request, urlopen
 
request = Request(
    "https://backendapi.sayswitchgroup.com/api/v1/subscription/SUB_7q2m9x4k1v8b5n3p6r0s/cancel",
    method="POST",
    headers={
        "Authorization": "Bearer YOUR_SECRET_KEY",
        "Accept": "application/json",
    },
)
 
with urlopen(request) as response:
    response_body = response.read().decode()
    print(response.status, response_body)

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
 
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://backendapi.sayswitchgroup.com/api/v1/subscription/SUB_7q2m9x4k1v8b5n3p6r0s/cancel"))
    .header("Authorization", "Bearer YOUR_SECRET_KEY")
    .header("Accept", "application/json")
    .method("POST", HttpRequest.BodyPublishers.noBody())
    .build();
 
var response = HttpClient.newHttpClient().send(
    request,
    HttpResponse.BodyHandlers.ofString()
);
 
System.out.println(response.statusCode());
System.out.println(response.body());

Update Endpoint

PUT https://backendapi.sayswitchgroup.com/api/v1/subscription/{id_or_code}

curl --request PUT \
  --url https://backendapi.sayswitchgroup.com/api/v1/subscription/SUB_7q2m9x4k1v8b5n3p6r0s \
  --header "Authorization: Bearer YOUR_SECRET_KEY" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{
    "action": "cancel"
  }'

// Run secret-key requests on your server.
const response = await fetch("https://backendapi.sayswitchgroup.com/api/v1/subscription/SUB_7q2m9x4k1v8b5n3p6r0s", {
  method: "PUT",
  headers: {
    "Authorization": "Bearer YOUR_SECRET_KEY",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "action": "cancel"
  })
});
 
const responseBody = await response.text();
console.log(response.status, responseBody);

<?php
$request = curl_init('https://backendapi.sayswitchgroup.com/api/v1/subscription/SUB_7q2m9x4k1v8b5n3p6r0s');
 
curl_setopt_array($request, [
    CURLOPT_CUSTOMREQUEST => 'PUT',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_SECRET_KEY',
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => '{
    "action": "cancel"
  }',
]);
 
$responseBody = curl_exec($request);
$status = curl_getinfo($request, CURLINFO_HTTP_CODE);
curl_close($request);
 
echo $status . PHP_EOL;
echo $responseBody;

from urllib.request import Request, urlopen
 
payload = "{\n    \"action\": \"cancel\"\n  }".encode()
 
request = Request(
    "https://backendapi.sayswitchgroup.com/api/v1/subscription/SUB_7q2m9x4k1v8b5n3p6r0s",
    data=payload,
    method="PUT",
    headers={
        "Authorization": "Bearer YOUR_SECRET_KEY",
        "Accept": "application/json",
        "Content-Type": "application/json",
    },
)
 
with urlopen(request) as response:
    response_body = response.read().decode()
    print(response.status, response_body)

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
 
var body = """
    {
        "action": "cancel"
      }
    """;
 
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://backendapi.sayswitchgroup.com/api/v1/subscription/SUB_7q2m9x4k1v8b5n3p6r0s"))
    .header("Authorization", "Bearer YOUR_SECRET_KEY")
    .header("Accept", "application/json")
    .header("Content-Type", "application/json")
    .method("PUT", HttpRequest.BodyPublishers.ofString(body))
    .build();
 
var response = HttpClient.newHttpClient().send(
    request,
    HttpResponse.BodyHandlers.ofString()
);
 
System.out.println(response.statusCode());
System.out.println(response.body());

{id_or_code} accepts either the numeric ID or subscription_code. cancel is the only supported update action in v1.

Response

{
  "status": true,
  "message": "Subscription cancelled.",
  "data": {
    "subscription_code": "SUB_7q2m9x4k1v8b5n3p6r0s",
    "status": "cancelled",
    "next_charge_at": null,
    "cancelled_at": "2026-10-15T09:45:00.000000Z",
    "authorization_url": null
  }
}

Cancellation is idempotent. Cancelling an already-cancelled subscription returns a successful response with its existing cancelled state and does not send another cancellation event.

Subscriptions that are already completed or expired are also returned unchanged with a successful response. Their status is not changed to cancelled.

Invalid Update Action

HTTP 422:

{
  "status": false,
  "message": "Only cancellation is supported in this version.",
  "errors": {
    "action": [
      "The selected action is invalid."
    ]
  }
}

Subscription Not Found

HTTP 404:

{
  "status": false,
  "message": "Subscription not found."
}

Get Subscription Details Webhooks