Skip to main content
POST
Cancel & Refund
Cancel a subscription immediately and credit the full amount of its most recent paid invoice back to your Stripe billing account balance. Designed for reseller organizations whose end-customer’s payment failed after our subscription had already renewed.
This cancels the subscription immediately (not at period end) and queues the proxies for deletion right away. The order is marked expired.

Requirements

  • Organization API key only — user-scoped keys receive 403
  • The cancel_refund feature must be enabled for your organization (contact support)
  • Must be called within 3 days (72 hours) of the most recent invoice payment
  • The order must be active or cancelled (not expired), and not a crypto subscription

Effects

When successful:
  1. The order is marked expired
  2. The Stripe subscription is cancelled immediately (not at period end)
  3. The invoice amount is credited to the Stripe customer the order was billed to
  4. The proxies are queued for deletion right away

Request

Headers

Path Parameters

string
required
The subscription ID from order creation.
string
required
The product ID (e.g., "captcha").

Example Request

Response

Success Response

Response Fields

string
Status of the request.
string
Human-readable result message.
string
The order ID that was processed.
string
The Stripe subscription that was cancelled.
number
Amount credited, in dollars.
integer
Amount credited, in cents.
string
The Stripe invoice that was credited.
number
Hours between the invoice payment and this request.

Error Responses

403 Forbidden - Not an Organization Key

403 Forbidden - Feature Not Enabled

400 Bad Request - No Billing Account

400 Bad Request - Order Not Processable

400 Bad Request - Crypto Subscription

400 Bad Request - No Paid Invoices

400 Bad Request - Refund Window Passed

404 Not Found

409 Conflict - Already Processed

500 Internal Server Error

Delete Order

Schedule a cancellation at period end (no immediate refund).

List Orders

Check an order’s current status.