Reactivate Subscription

Reactivate a subscription that is currently in canceling state. The pending end-of-period cancellation is removed and the subscription continues to renew as scheduled.

POST /v1/actions/subscription-order/reactivate-order

Authentication: Session Token — see Customer Endpoints (customer or customer role)

Reactivation Behavior

Current Status	Action	Result Status
`canceling`	Remove pending end-of-period cancellation (via PSP)	`active`
`canceled`	Not allowed — already fully canceled	—
`pending` / `active` / `past_due` / `expired`	Not allowed — only `canceling` is reactivatable	—

Only subscriptions in canceling (cancellation scheduled at period end) can be reactivated.
Fully canceled (canceled) subscriptions cannot be reactivated — start a new subscription instead.
A subscription that had an unpaid charge at the moment cancellation was requested cannot be reactivated — the request is refused with 400 and a distinct message. Cancelling a past_due subscription always falls into this category; a normal end-of-period cancellation from active usually does not.
A subscription whose plan change has been confirmed by the payment channel cannot be reactivated — it is canceling because of that change, not because the buyer cancelled, and the channel put it into pending cancellation the moment it confirmed the change, with no way back. The refusal also stands after the change is voided (its pending new subscription cancelled or closed). Such a subscription moves one way to canceled; to keep paying, the buyer has to place a new order.
No additional charge — the current billing period continues, and renewal resumes at its original schedule.

Request Body

Field	Type	Required	Description
`orderId`	string	Yes	Subscription order ID (Short ID format `ORD_xxx`)

Example Request

import { WaffoPancake } from "@waffo/pancake-ts";

const client = new WaffoPancake({
  sessionToken: window.WAFFO_SESSION_TOKEN, // injected by the merchant's portal
  environment: "prod",
});

const result = await client.orders.reactivateSubscription({
  orderId: "ORD_2aUyqjCzEIiEcYMKj7TZtw",
});

console.log(result.orderId); // "ORD_2aUyqjCzEIiEcYMKj7TZtw"
console.log(result.status);  // "active"

const result = await fetch("https://api.waffo.ai/v1/actions/subscription-order/reactivate-order", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${SESSION_TOKEN}`,
    "Content-Type": "application/json",
    "X-Environment": "prod",
  },
  body: JSON.stringify({
    orderId: "ORD_2aUyqjCzEIiEcYMKj7TZtw",
  }),
}).then(r => r.json());

curl -X POST "https://api.waffo.ai/v1/actions/subscription-order/reactivate-order" \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -H "X-Environment: prod" \
  -d '{"orderId":"ORD_2aUyqjCzEIiEcYMKj7TZtw"}'

wget -qO- \
  --header="Authorization: Bearer $SESSION_TOKEN" \
  --header="Content-Type: application/json" \
  --header="X-Environment: prod" \
  --post-data='{"orderId":"ORD_2aUyqjCzEIiEcYMKj7TZtw"}' \
  "https://api.waffo.ai/v1/actions/subscription-order/reactivate-order"

Success Response (200)

{
  "data": {
    "orderId": "ORD_2aUyqjCzEIiEcYMKj7TZtw",
    "status": "active"
  }
}

Response Fields

Field	Type	Description
`orderId`	string	Order ID (Short ID)
`status`	string	New order status (`active`)

Errors

Retry policy: Never retry 4xx — fix the request and resubmit. Retry 5xx with exponential backoff (start 5s, max 3 attempts).

Status	`errors[0].message`	What it means	Recommended handling
400	`Missing required field: orderId`	`orderId` is missing, empty, or not a string	Fix the request body, then resubmit
400	`Invalid JSON body`	Request body is not valid JSON	Fix the request body, then resubmit
400	`Expected format: ORD_xxx, got "..."`	`orderId` Short ID could not be decoded	Fix the `orderId` format, then resubmit
400	`Only canceling subscriptions can be reactivated`	Order status is not `canceling` (e.g. `canceled`, `active`, `expired`)	The subscription is not reactivatable
400	`Subscription with an unpaid balance cannot be reactivated`	The subscription had an unpaid charge when cancellation was requested (always true for a `past_due` cancellation)	Cannot be reverted — start a new subscription instead. The message differs from the one above so the two refusals can be told apart
400	`Subscription with a confirmed plan change cannot be reactivated`	The subscription already has a plan change confirmed by the payment channel; the refusal stands whether or not that change was later voided	Cannot be reverted — the subscription moves one way to `canceled`. To keep paying, place a new order
401	`Authentication failed`	Session token invalid, expired, or malformed	Re-mint the session token via Issue Session Token
403	`Order does not belong to user`	Ownership check failed	Verify the caller owns the order
404	`Order not found`	Order does not exist	Verify the order ID
500	`Internal server error`	Unexpected server-side failure	Retry with exponential backoff (start 5s, max 3 attempts)

Overview

Auth

Merchant API (API Key)

Customer Portal API (Session Token)

GraphQL

Reactivation Behavior

Request Body

Example Request

Success Response (200)

Response Fields

Errors

​Reactivation Behavior

​Request Body

​Example Request

​Success Response (200)

​Response Fields

​Errors

Reactivation Behavior

Request Body

Example Request

Success Response (200)

Response Fields

Errors