Reseller API Documentation

Authorization: Bearer rk_YOUR_KEY
# or
X-API-Key: rk_YOUR_KEY

{
  "customer": "CUS-7K2M9QX4",
  "balance": "125.5000",
  "currency": "USD",
  "total_spent": "310.0000",
  "tier": "Silver",
  "tier_discount": "0.0300",
  "api_key": {
    "prefix": "rk_AbCdEfGh",
    "label": "API key 1",
    "rate_limit_per_minute": 60,
    "ip_restricted": true
  }
}

{
  "name": "AI Store Plus Reseller API",
  "version": "v1",
  "status": "ok",
  "base_url": "https://api.aistoreplus.com/v1",
  "documentation": "https://aistoreplus.com/en/reseller-api/"
}

{
  "total": 2,
  "currency": "USD",
  "products": [
    {
      "id": 127,
      "name": "Example Pro · 18 Months",
      "category": "AI",
      "price": "0.7000",
      "currency": "USD",
      "stock": 1581,
      "in_stock": true,
      "product_type": "code",
      "warranty_days": 0,
      "min_quantity": 1,
      "max_quantity": 25,
      "required_inputs": []
    },
    {
      "id": 2210,
      "name": "Example Team Seat · 1 Month",
      "category": "AI",
      "price": "14.0000",
      "currency": "USD",
      "stock": null,
      "in_stock": true,
      "product_type": "service",
      "warranty_days": 0,
      "min_quantity": 1,
      "max_quantity": 1,
      "required_inputs": [
        { "key": "customer_email", "label": "Email address (the invitation is sent here)" }
      ]
    }
  ]
}

{"product_id": 127, "quantity": 2, "idempotency_key": "my-order-10045"}

{
  "order": {
    "order_code": "ORD-C19QV1RX",
    "status": "completed",
    "status_detail": "delivered",
    "product_id": 127,
    "product_name": "Example Pro · 18 Months",
    "quantity": 2,
    "delivered_quantity": 2,
    "unit_price": "0.7000",
    "total": "1.4000",
    "refunded": "0.0000",
    "currency": "USD",
    "created_at": "2026-10-28T10:15:02.123456+00:00",
    "delivered_at": "2026-10-28T10:15:03.004512+00:00",
    "items": [
      "https://example.com/activate/AAAA-BBBB",
      "https://example.com/activate/CCCC-DDDD"
    ],
    "instructions": "Open the link while signed in to your own account.",
    "outcome": "delivered"
  },
  "replay": false
}

{
  "total": 37,
  "limit": 20,
  "offset": 0,
  "orders": [
    {
      "order_code": "ORD-C19QV1RX",
      "status": "completed",
      "status_detail": "delivered",
      "product_id": 127,
      "product_name": "Example Pro · 18 Months",
      "quantity": 2,
      "delivered_quantity": 2,
      "unit_price": "0.7000",
      "total": "1.4000",
      "refunded": "0.0000",
      "currency": "USD",
      "created_at": "2026-10-28T10:15:02.123456+00:00",
      "delivered_at": "2026-10-28T10:15:03.004512+00:00"
    }
  ]
}

{"url": "https://example.com/aistore/webhook"}

{
  "webhook": {
    "url": "https://example.com/aistore/webhook",
    "created_at": "2026-10-28T13:05:12+00:00",
    "last_success_at": null,
    "last_failure_at": null,
    "last_error": null,
    "consecutive_failures": 0
  },
  "secret": "whsec_k3Jx9Qm2LpV7tR8wYz4AbCdEfGhIjKlMnOpQrStUvWx"
}

{"delivered": true, "status": 200, "error": null}

{
  "id": "evt_1842",
  "event": "order.completed",
  "created_at": "2026-10-28T13:10:41+00:00",
  "order": {
    "order_code": "ORD-C19QV1RX",
    "status": "completed",
    "status_detail": "delivered",
    "product_id": 127,
    "product_name": "Example Pro · 18 Months",
    "quantity": 1,
    "delivered_quantity": 1,
    "unit_price": "0.7000",
    "total": "0.7000",
    "refunded": "0.0000",
    "currency": "USD",
    "created_at": "2026-10-28T13:10:38+00:00",
    "delivered_at": "2026-10-28T13:10:39+00:00",
    "items": ["https://example.com/activate/AbC123"],
    "instructions": "Open the link and sign in with your own account."
  }
}

import hashlib, hmac, time

def verify(secret: str, headers: dict, raw_body: bytes) -> bool:
    timestamp = headers["X-AIStore-Timestamp"]
    if abs(time.time() - int(timestamp)) > 300:  # older than 5 minutes
        return False
    expected = "v1=" + hmac.new(
        secret.encode(), timestamp.encode() + b"." + raw_body, hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(expected, headers["X-AIStore-Signature"])

<?php
$secret    = getenv('AISTORE_WEBHOOK_SECRET');
$raw       = file_get_contents('php://input');           // raw body, before json_decode
$timestamp = $_SERVER['HTTP_X_AISTORE_TIMESTAMP'] ?? '';
$signature = $_SERVER['HTTP_X_AISTORE_SIGNATURE'] ?? '';
$expected  = 'v1=' . hash_hmac('sha256', $timestamp . '.' . $raw, $secret);
if (abs(time() - (int) $timestamp) > 300 || !hash_equals($expected, $signature)) {
    http_response_code(401);
    exit;
}
$event = json_decode($raw, true);   // $event['event'], $event['order']
http_response_code(200);

{
  "error": {
    "code": "insufficient_balance",
    "message": "Insufficient balance."
  }
}

# Products
curl https://api.aistoreplus.com/v1/products \
  -H "Authorization: Bearer rk_YOUR_KEY"

# Place an order (use a unique idempotency_key per order)
curl -X POST https://api.aistoreplus.com/v1/orders \
  -H "Authorization: Bearer rk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id": 127, "quantity": 1, "idempotency_key": "my-order-10045"}'

import requests

API = "https://api.aistoreplus.com/v1"
HEADERS = {"Authorization": "Bearer rk_YOUR_KEY"}

products = requests.get(f"{API}/products", headers=HEADERS, timeout=30).json()["products"]
item = next(p for p in products if p["id"] == 127 and p["in_stock"])

resp = requests.post(
    f"{API}/orders",
    headers=HEADERS,
    json={"product_id": item["id"], "quantity": 1, "idempotency_key": "my-order-10045"},
    timeout=90,
)
data = resp.json()
if resp.status_code in (200, 201):
    order = data["order"]
    print(order["order_code"], order["status"], order.get("items"))
else:
    print("Error:", data["error"]["code"], data["error"]["message"])

<?php
$api = 'https://api.aistoreplus.com/v1';
$key = 'rk_YOUR_KEY';

$ch = curl_init("$api/orders");
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 90,
    CURLOPT_HTTPHEADER     => ["Authorization: Bearer $key", 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode([
        'product_id'      => 127,
        'quantity'        => 1,
        'idempotency_key' => 'my-order-10045',
    ]),
]);
$body   = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);

if ($status === 200 || $status === 201) {
    echo $body['order']['order_code'], ' ', $body['order']['status'], PHP_EOL;
} else {
    echo 'Error: ', $body['error']['code'], PHP_EOL;
}

const API = "https://api.aistoreplus.com/v1";
const headers = { Authorization: "Bearer rk_YOUR_KEY", "Content-Type": "application/json" };

const res = await fetch(`${API}/orders`, {
  method: "POST",
  headers,
  body: JSON.stringify({ product_id: 127, quantity: 1, idempotency_key: "my-order-10045" }),
});
const data = await res.json();
if (res.ok) {
  console.log(data.order.order_code, data.order.status, data.order.items);
} else {
  console.error(data.error.code, data.error.message);
}