Knowledgebase

Buys an server under your Sive.Host account. For more flow control, this method will Automatically setup the product bought as soon as your Sive.Host credit is more than the cost of the server. When you call this method, you must understand that that your credit will be reduced by the amount the server costs. One item can be bought per API call.

Request Parameters

Response Parameters

Example Request (CURL)

<?php
//Invalid Payment Method. Valid options include pai,banktransfer,metamaskusdterc20,paypal,payfast
$apiUrl = 'https://sive.host/includes/sivehost-api.php'; // Change to your API endpoint
$username = 'Ikhaka'; // Your API username
$password = 'Mph#th9mi$'; // Your API password

$postfields = array(
    'api_key' => 'G2dskdXb7BlDwlvbrD1zVEe5ZKQIybXn', // If needed
    'api_secret' => 'CtIJVZf8OM1p4iLxwiKFjlU4bPVmEycS', // If needed    
    'action' => 'BuyNow',
    'pid' => 'benueriver',
    'os' => 'alma8',
    'hostname' => 'ikhaka',
    'username' => 'mandela',    
    'rootpw' => 'MyStrongpassword',  
    'sshkey' => 'ssh-rsa AAAAB3NzaC1yc2E...CKM= sivehost@Sive',  
    'billingcycle' => 'monthly',
    'nameserver1' => 'ns1.hostname.com',
    'nameserver2' => 'ns2.hostname.com',
);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $apiUrl);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($postfields));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password"); // Basic Authentication
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // Use true in production with a valid SSL

$response = curl_exec($ch);

// Check for cURL errors
if (curl_errno($ch)) {
    echo 'cURL Error: ' . curl_error($ch);
}
    
curl_close($ch);

// Output response
echo $response;
?>

Example Response JSON

{
    "result": "success",
    "orderid": 13026,
    "serviceid": "12632",
    "invoiceid": 113690
}

Error Responses

Version History