-
API Reference
- AcceptOrder
- AcceptQuote
- ActivateModule
- AddAnnouncement
- AddBannedIp
- AddBillableItem
- AddCancelRequest
- AddClient
- AddClientNote
- AddContact
- AddCredit
- AddInvoicePayment
- AddOrder
- AddPayMethod
- AddProduct
- AddProjectMessage
- AddProjectTask
- AddTicketNote
- AddTicketReply
- AddTransaction
- AddUser
- AffiliateActivate
- ApplyCredit
- BlockTicketSender
- CancelOrder
- CapturePayment
- CloseClient
- CreateClientInvite
- CreateInvoice
- CreateOAuthCredential
- CreateOrUpdateTLD
- CreateProject
- CreateQuote
- CreateSsoToken
- DeactivateModule
- DecryptPassword
- DeleteAnnouncement
- DeleteClient
- DeleteContact
- DeleteOAuthCredential
- DeleteOrder
- DeletePayMethod
- DeleteProjectTask
- DeleteQuote
- DeleteTicket
- DeleteTicketNote
- DeleteTicketReply
- DeleteUserClient
- DomainGetLockingStatus
- DomainGetNameservers
- DomainGetWhoisInfo
- DomainRegister
- DomainRelease
- DomainRenew
- DomainRequestEPP
- DomainToggleIdProtect
- DomainTransfer
- DomainUpdateLockingStatus
- DomainUpdateNameservers
- DomainUpdateWhoisInfo
- DomainWhois
- EncryptPassword
- EndTaskTimer
- FraudOrder
- GenInvoices
- GetActivityLog
- GetAdminDetails
- GetAdminUsers
- GetAffiliates
- GetAnnouncements
- GetAutomationLog
- GetCancelledPackages
- GetClientGroups
- GetClientPassword
- GetClients
- GetClientsAddons
- GetClientsDetails
- GetClientsDomains
- GetClientsProducts
- GetConfigurationValue
- GetContacts
- GetCredits
- GetCurrencies
- GetEmailTemplates
- GetEmails
- GetHealthStatus
- GetInvoice
- GetInvoices
- GetModuleConfigurationParameters
- GetModuleQueue
- GetOrderStatuses
- GetOrders
- GetPayMethods
- GetPaymentMethods
- GetPermissionsList
- GetProducts
- GetProject
- GetProjects
- GetPromotions
- GetQuotes
- GetRegistrars
- GetServers
- GetStaffOnline
- GetStats
- GetSupportDepartments
- GetSupportStatuses
- GetTLDPricing
- GetTicket
- GetTicketAttachment
- GetTicketCounts
- GetTicketNotes
- GetTicketPredefinedCats
- GetTicketPredefinedReplies
- GetTickets
- GetToDoItemStatuses
- GetToDoItems
- GetTransactions
- GetUserPermissions
- GetUsers
- ListOAuthCredentials
- LogActivity
- MergeTicket
- ModuleChangePackage
- ModuleChangePw
- ModuleCreate
- ModuleCustom
- ModuleSuspend
- ModuleTerminate
- ModuleUnsuspend
- OpenTicket
- OrderFraudCheck
- PendingOrder
- ResetPassword
- SendAdminEmail
- SendEmail
- SendQuote
- SetConfigurationValue
- StartTaskTimer
- TriggerNotificationEvent
- UpdateAdminNotes
- UpdateAnnouncement
- UpdateClient
- UpdateClientAddon
- UpdateClientDomain
- UpdateClientProduct
- UpdateContact
- UpdateInvoice
- UpdateModuleConfiguration
- UpdateOAuthCredential
- UpdatePayMethod
- UpdateProject
- UpdateProjectTask
- UpdateQuote
- UpdateTicket
- UpdateTicketReply
- UpdateToDoItem
- UpdateTransaction
- UpdateUser
- UpdateUserPermissions
- UpgradeProduct
- ValidateLogin
- WhmcsDetails
DeleteOrder
Deletes a cancelled or fraud order.
Removes an order from the system. This cannot be undone. This will remove all items associated with the order (services, addons, domains, invoices etc)
Request Parameters
Parameter | Type | Description | Required |
---|---|---|---|
action | string | “DeleteOrder” | Required |
orderid | int | The order to be deleted | Required |
Response Parameters
Parameter | Type | Description |
---|---|---|
result | string | The result of the operation: success or error |
Example Request (CURL)
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://www.example.com/includes/api.php');
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,
http_build_query(
array(
'action' => 'DeleteOrder',
// See https://developers.whmcs.com/api/authentication
'username' => 'IDENTIFIER_OR_ADMIN_USERNAME',
'password' => 'SECRET_OR_HASHED_PASSWORD',
'orderid' => '1',
'responsetype' => 'json',
)
)
);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($ch);
curl_close($ch);
Example Request (Local API)
$command = 'DeleteOrder';
$postData = array(
'orderid' => '1',
);
$adminUsername = 'ADMIN_USERNAME'; // Optional for WHMCS 7.2 and later
$results = localAPI($command, $postData, $adminUsername);
print_r($results);
Example Response JSON
{
"result": "success"
}
Error Responses
Possible error condition responses include:
- Order ID not found
- The order status must be in Cancelled or Fraud to be deleted
Version History
Version | Changelog |
---|---|
1.0 | Initial Version |