Create Activation

Updated 10 September 2026

POST `?action=create_activation`

Creates a new activation work order. Payment must be confirmed before calling — the work order is queued immediately and provisioned within 1 minute.

Request Parameters

Field	Type	Required	Description
`product_id`	integer	Required	Panelr product ID
`customer_email`	string	Required	Customer email address
`payment_method_id`	integer	Required	Panelr payment method ID
`customer_name`	string	Optional	Customer full name
`customer_phone`	string	Optional	Customer phone number
`payment_transaction_id`	string	Optional	WooCommerce order/transaction ID
`payment_amount`	float	Optional	Amount paid
`is_free`	boolean	Optional	Set true for free orders
`bouquet_ids`	array	Optional	Explicit bouquet IDs to assign. Must belong to the same service as the product — ids from another service mean nothing to that panel
`categories`	array	Optional	Category names: live, vod, series. Expanded to bouquets belonging to the same service as the item being ordered — another service's categories are not included
`notes`	string	Optional	Internal admin notes
`pay_with_points`	boolean	Optional	Pay for the line with the customer’s credits — no payment method needed and no money changes hands. Requires a credit-priced plan on a participating service and a covering balance
`referral_code`	string	Optional	Invite code the customer arrived with. Stale codes are dropped silently
`idempotency_key`	string	Optional	Your own reference for this request (defaults to `wc_order_id`, then `payment_transaction_id`). Send the same key again after a timeout or retry and you get the original order back with `already: true` instead of a second order
`credits_spent`	integer	Credits debited when the line was paid for with credits (0 otherwise)

Response

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

The order is provisioned asynchronously within ~1 minute. Store work_order_id for reference.

Example request

$payload = [
    'product_id'             => 1,
    'customer_email'         => '[email protected]',
    'customer_name'          => 'John Doe',
    'payment_method_id'      => 1,
    'payment_transaction_id' => 'wc_order_abc123',
    'payment_amount'         => 9.99,
];
$ch = curl_init('PANELR_API_URL?action=create_activation');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => json_encode($payload),
    CURLOPT_HTTPHEADER     => [
        'X-Panelr-API-Key: YOUR_API_KEY',
        'Content-Type: application/json',
    ],
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

curl -X POST "PANELR_API_URL?action=create_activation" \
  -H "X-Panelr-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_id": 1,
    "customer_email": "[email protected]",
    "customer_name": "John Doe",
    "payment_method_id": 1,
    "payment_transaction_id": "wc_order_abc123",
    "payment_amount": 9.99
  }'

const res = await fetch('PANELR_API_URL?action=create_activation', {
  method: 'POST',
  headers: {
    'X-Panelr-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    product_id: 1,
    customer_email: '[email protected]',
    customer_name: 'John Doe',
    payment_method_id: 1,
    payment_transaction_id: 'wc_order_abc123',
    payment_amount: 9.99,
  }),
});
const { data } = await res.json();
// data.work_order_id, data.reference_code

import requests
r = requests.post('PANELR_API_URL',
    params={'action': 'create_activation'},
    headers={'X-Panelr-API-Key': 'YOUR_API_KEY'},
    json={
        'product_id': 1,
        'customer_email': '[email protected]',
        'customer_name': 'John Doe',
        'payment_method_id': 1,
        'payment_transaction_id': 'wc_order_abc123',
        'payment_amount': 9.99,
    })
data = r.json()['data']

POST ?action=create_activation

Request Parameters

Response

POST `?action=create_activation`