X
X
NGN

Knowledge Base

HomepageKnowledge BaseReseller HostingReseller API Documentation

Reseller API Documentation

Global Reseller API & White-Label Program Guide (2026)
 
Welcome to the official developer reference manual for the CoLi Hosting Reseller Program. This document outlines our white-label program architecture, wholesale tier discounts, and the technical guidelines required to link your external storefront platform (such as custom scripts, WHMCS, or WISECP portals) programmatically to our central cloud virtualization clusters.
 
1. Global Program & Structural Benefits
 
Our developer-first program allows web design agencies, IT consulting firms, and software freelancers worldwide to resell high-performance cloud infrastructure under their own independent business names and logos.
 
  • 100% White-Labeled Identity: Your customers see and purchase from your brand; our backend infrastructure remains completely invisible.
  • Multi-Currency Core Billing: Fund your master wallet seamlessly using USD, Ghanaian Cedis (GHS), or major international credit card payment networks.
  • Turnkey REST API Modules: Automate the entire subscription life-cycle from account creation to instant infrastructure server delivery.
  • Direct Regional Network Peering: Guarantee lightning-fast page loading speeds and ultra-low server latency response windows across your regional client deployments.
2. Wholesale Volume Discount Brackets
 
Your account automatically gains access to compounding price drops based on the total number of active, continuous server nodes or software setups maintained inside your developer dashboard:
 
  • Tier 1 (Between 2 and 3 Active Orders): 5% Flat Discount
  • Tier 2 (Between 4 and 10 Active Orders): 12% Flat Discount
  • Tier 3 (Between 11 and 50 Active Orders): 22% Maximum Wholesale Discount
Program Terms: Account auto-activation requires a minimum initial wallet deposit threshold of $100.00 USD (or 1,150.00 GHS local equivalent). To protect our raw infrastructure networks, applied system discounts cannot fall below a $5.00 USD (or 50 GHS) baseline protection floor threshold per order.
 
3. Core API Connection Protocol
 
To establish a stable server-to-server connection loop, your custom applications must communicate with our central API gateway using these global technical network properties:
 
  • API Gateway URL: https://hosting.coli.com.gh/api/reseller/
  • Network Request Method: Strict HTTP POST
  • Content-Type Header: Must explicitly declare application/json
  • Payload Syntax Format: Inputs and server callback data variables are structured entirely using the JSON standard.
Mandatory Core Authentication Headers
 
Every background API command sent to our ecosystem must include these two master verification variables sitting inside the root data scope layer:
 
  1. key (String): The private alphanumeric reseller API token key copied from your client security control panel tab.
  2. action (String): The precise function string telling our server backend which automated action to fire up.
4. Primary API Action Endpoints
 
A. Fetch System Inventory Products
Queries our inventory matrix to output a clean list of available Cloud VPS sizes, isolated VDS hardware resources, CyberPanel setups, and domain extensions with your custom tier pricing values attached.
 
  • Action Command String: products
  • Example Payload: { "key": "YOUR_API_TOKEN", "action": "products" }
B. Deploy a New Infrastructure Asset (Order Node)
Claims dedicated virtualization resources, maps storage targets, and spins up a brand-new cloud workspace for your buyer instantly. Invoicing balances are auto-deducted directly from your credit wallet balance.
 
  • Action Command String: buy
  • Required Parameter Variables: product_id (integer), period (monthly/annually), and domain (hostname, e.g., ://yoursite.com).
C. Query Infrastructure Node Details
Pulls deep real-time virtualization monitoring states, assigned IP routing blocks, reverse DNS settings, and administrative control environment links.
  • Action Command String: order/detail
  • Required Parameter Variables: order_id (integer).
D. Initialize Subscription Renewal
Extends a service asset record using your active account credit balance, preventing downtime by locking in seamless recurring contract dates.
  • Action Command String: order/renewal
  • Required Parameter Variables: order_id (integer).

5. Platform Error Code Handling Matrix
 
If a backend automation command fails or a code string is rejected by our authentication framework, the API will output a clean error status code dictionary response:
 
  • INVALID_KEY: The API token string provided is missing, expired, or failed security validation checks.
  • UNKNOWN_ACTION: The system action parameter requested is misspelled or unsupported by this API version.
  • INSUFFICIENT_FUNDS: Your master reseller wallet deposit drops below the wholesale cost of the deployment target. Load a minimum credit deposit immediately to resume automated activations.
  • LIMIT_EXCEEDED: Your platform is executing rapid, repetitive code calls that break our baseline security rate-limiting rules.

 

Can't find the information you are looking for?

Create a Support Ticket
Did you find it useful?
(210 times viewed / 1 people found it helpful)

🌍
100% African Infrastructure
● Flagship Hub: Accra, Ghana
Directly Peered to Nigeria & South Africa
Top