Buys an hosting service 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
Parameter |
Type |
Description |
Required |
action |
string |
“BuyNow” |
Required |
pid |
string |
The product code as per Product codes page. eg. lomamiriver, benueriver, okavangoriver, kuneneriver, shebelleriver, kasairiver |
Required |
api_key |
string |
API key credentials as per Authentication instructions |
Required |
api_secret |
string |
API secret credentials as per Authentication instructions |
Required |
billingcycle |
string |
The billing cycle for the product. eg. monthly |
Required |
domain |
string |
The website address you are buying or buying the hosting plan for. |
Required |
domaintype |
string |
register or transfer |
Optional |
regperiod |
string |
For website address registrations, the registration periods for the website address in the order |
Required |
eppcode |
string |
For website address transfers. The epp codes for the website address being transferred in the order |
Required |
nameserver1 |
string |
The first nameserver to apply. eg. ekhaya.sive.host |
Optional |
nameserver2 |
string |
The second nameserver to apply. eg. ekhaya.sivehost.com |
Optional |
Response Parameters
Parameter |
Type |
Description |
result |
string |
The result of the operation: success or error |
orderid |
int |
The Order ID for the by the succesful purchase. |
serviceid |
string |
The Service ID created by the succesful purchase. |
invoiceid |
int |
The Invoice ID created by the succesful purchase. |
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',
'domain' => 'almaSiveHost.co.za',
'domaintype' => 'transfer',
'regperiod' => '1',
'eppcode' => '12345Epp',
'billingcycle' => 'annually',
'nameserver1' => 'ekhaya.sive.host',
'nameserver2' => 'ekhayas.sivehost.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
Error Message |
Cause |
Unauthorized access! |
Request from unauthorized IP |
Invalid API Key or secret. |
Incorrect API credentials |
Invalid Product or Operating System. |
Unknown product or Operating System for that product |
Missing action parameter. |
action not specified eg. BuyNow |
Insufficient credit to place the order. |
Not enough account balance. Load credit on Sive.Host client area. |
Invalid Payment Method. Valid options include |
Payment method not specified on payload. |
Version History
Version |
Changelog |
1.0 |
Initial Version |