Reseller APIs documentation.

Overview

Approved reseller accounts can sell the same live catalog in two different ways. Both integrations use your existing reseller key, prepaid balance, reseller pricing, stock and fulfilment engine; only the external protocol is different.

Choose the right API

SMM Panel API

This endpoint follows the common POST-based SMM provider format. Add it as a provider in your SMM panel and use your approved reseller API key.

Service list

key=rsk_YOUR_KEY&action=services

[
  {
    "service": 101,
    "name": "ChatGPT Plus 1 Month",
    "type": "Default",
    "category": "ChatGPT",
    "rate": "5000.00",
    "min": "1",
    "max": "8",
    "desc": "Enter the customer's delivery email in the Link field.",
    "refill": false,
    "cancel": true
  }
]

Add order

For digital products the Link field is the customer delivery email. The API also accepts url, email or customer_email aliases when the sending software supports them.

key=rsk_YOUR_KEY&action=add&service=101&[email protected]&quantity=1

{
  "order": 58421
}

Order status

key=rsk_YOUR_KEY&action=status&order=58421

{
  "charge": "5.00",
  "start_count": "0",
  "status": "Completed",
  "remains": "0",
  "currency": "USD"
}

The status response never exposes customer credentials. Access details are delivered to the email supplied with the order.

Balance

key=rsk_YOUR_KEY&action=balance

{
  "balance": "100.84",
  "currency": "USD"
}

Automatic stock sync

SMM services use stable service IDs. When a product runs out of stock it becomes unavailable in the provider feed; when stock returns, the same service ID becomes available again. You do not need to recreate or remap the service.

• Finite stock automatically limits the SMM max quantity.
• Out-of-stock services are blocked even if the reseller panel has not synced yet.
• No wallet deduction or provider purchase is made when the service is unavailable.
• Restocking clears the catalog state so the next provider sync can reopen the same service.

{
  "error": "Service temporarily unavailable"
}

Developer API authentication

Create a key in your panel under Reseller API. Keys start with rsk_ and are shown only once, so store yours on your server when you create it. You can revoke a key at any time and restrict it to your server IP addresses.

Send the key in one of these ways (the first one found is used):

• Authorization: Bearer rsk_... - recommended
• X-API-Key: rsk_...
• ?key=rsk_... query parameter, or "key" in the JSON body (avoid: URLs end up in logs)

curl -s "https://aitoolspro.org/wp-json/reseller/v2/me" \
  -H "Authorization: Bearer rsk_YOUR_KEY"

{
  "success": true,
  "account": { "id": 123, "name": "My Shop", "reseller": true,
               "discountPercent": 20, "balance": 48.5, "currency": "USD" },
  "key": { "prefix": "rsk_AbCdEf", "label": "My panel" },
  "limits": { "requestsPerMinute": 120 },
  "apiVersion": "2.0"
}

Rate limits

Each key may make 120 requests per minute. Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Above the limit the API answers 429 RATE_LIMITED with a Retry-After header; wait that many seconds before trying again.

Poll the catalog every 30 to 60 seconds at most: stock and prices are refreshed about once a minute.

Safe retries

Send an Idempotency-Key header (1 to 100 characters: letters, digits and . _ : -) with every purchase, for example your own order number. Repeating the same request with the same key never buys twice; it returns the original order and its delivery once ready.

• Same key, same body: the same order (HTTP 200, "idempotentReplay": true).
• Same key, different product, quantity or customer_email: 422 IDEMPOTENCY_CONFLICT.
• Same key while the first request is still running: 409 REQUEST_IN_PROGRESS. Retry in a minute.
• A refused attempt (for example low balance) can be repeated with the same key after you fix the cause.

Endpoints

Prices are already your reseller price. Plans of one service are listed as separate products. availability.available is 0 when sold out; 999 means no fixed limit. When purchaseRequirements.customerEmail is true you must send customer_email (the end customer's address, where invites are sent). quantityFixed: 1 means one unit per request.

{
  "success": true,
  "currency": "USD",
  "count": 1,
  "products": [
    {
      "productId": "svc_123",
      "name": "ChatGPT Plus - 1 Month",
      "description": "Private account with full access...",
      "image": "https://aitoolspro.org/wp-content/uploads/chatgpt.png",
      "category": "AI Tools",
      "productType": "account",
      "price": { "amount": 4.5, "currency": "USD", "text": "$4.50", "suggestedRetail": 5.5 },
      "availability": { "available": 12, "inStock": true },
      "purchaseRequirements": { "customerEmail": false, "minQuantity": 1, "maxQuantity": 20 }
    }
  ]
}

{ "success": true, "balance": 48.5, "currency": "USD", "balanceText": "$48.50" }

Top up in your panel: Add funds.

Buying

curl -s -X POST "https://aitoolspro.org/wp-json/reseller/v2/purchase" \
  -H "Authorization: Bearer rsk_YOUR_KEY" \
  -H "Idempotency-Key: order-1001" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"svc_123","quantity":1,"reference":"order-1001"}'

{
  "success": true,
  "idempotentReplay": false,
  "order": {
    "orderCode": "R7K2M9QX4PZA",
    "status": "completed",
    "productId": "svc_123",
    "quantity": 1,
    "reference": "order-1001",
    "createdAt": "2026-09-13T10:00:00+00:00",
    "deliveredAt": "2026-09-13T10:00:04+00:00"
  },
  "payment": { "amount": 4.5, "currency": "USD", "unitPrice": 4.5, "refundedAmount": 0, "balanceAfter": 44.0 },
  "delivery": { "items": [ { "Email": "[email protected]", "Password": "••••••••" } ] },
  "deliveryText": "Email: [email protected]\nPassword: ••••••••"
}

Your balance is charged the reseller price multiplied by the quantity. The response shows the current order state; products that support synchronous delivery may also return delivery details in that response.

Order status

While an order is processing, either poll GET /orders/{orderCode} or repeat the same purchase with the same Idempotency-Key. Back off between checks: 1 minute, 2, 5, 15, then hourly.

curl -s "https://aitoolspro.org/wp-json/reseller/v2/orders/R7K2M9QX4PZA" \
  -H "Authorization: Bearer rsk_YOUR_KEY"

Delivery format

delivery.items holds one object per delivered unit. Labelled lines such as "Email: ..." become fields; any other text is kept under Access or Note. deliveryText carries the same details as plain text, ready to show to your customer.

Errors

Every error has the same shape. Branch on error.code, show message to people.

{
  "success": false,
  "message": "Insufficient balance. You need $1.20 more. Top up, then retry with the same Idempotency-Key.",
  "error": { "code": "INSUFFICIENT_BALANCE", "message": "..." },
  "requestId": "req_..."
}

Child panel setup

Running AI Pro Control on your own domain? Connect it in one minute:

1. Open Control > API > Add provider.
2. Adapter: AI Pro reseller API (parent panel).
3. Base URL: https://aitoolspro.org
4. Paste your rsk_ key, tick Enable, save, then press Test connection.
5. Open API products and import the services you want to sell with your own prices.

Other Buyer API v2 software: use the base URL above with the paths /products, /balance and /purchase, and send the key as a Bearer token or X-API-Key header.

Get a child panel on your own domain

Best practices

• Keep keys on your server. Never put a key in a browser, mobile app or public repository.
• Use one key per shop or bot, restrict each key to your server IPs, and revoke keys you no longer use.
• Always send an Idempotency-Key with purchases and reuse it for retries of the same order.
• Check GET /balance before busy periods and top up early; low balance pauses orders.
• Cache the catalog for 30-60 seconds instead of requesting it for every visitor.