Panelr

Create Renewal

POST ?action=create_renewal

Renews an existing activation directly, from a payment you have already taken — no cart, no admin review: the order is written as paid and queued for provisioning at once. The renewal product must be on the line's own service and have equal or greater connections than the current product (unless the current line is a free trial).

This is the store operator's tool (a back office, a bot). A storefront checkout renews through create_work_order (manual payment) or complete_order (confirmed automatic payment) with intent renewal on the item — that path carries coupons, credits and the customer's own payment method. Plain renewals never earn referral credits, on any path.

Request Parameters

FieldTypeRequiredDescription
activation_idintegerRequiredActivation ID to renew
product_idintegerRequiredRenewal product ID
payment_method_idintegerRequiredPanelr payment method ID
payment_transaction_idstringOptionalWooCommerce order/transaction ID
payment_amountfloatOptionalAmount paid
is_freebooleanOptionalSet true for free renewals
notesstringOptionalInternal admin notes

Response

{
  "success": true,
  "data": {
    "work_order_id": 43,
    "reference_code": "WO-2026-12346",
    "status": "queued"
  },
  "error": null
}