Create purchase order

Create a purchase order for any Hostinger product.

Create purchase order

post

Create a purchase order for any Hostinger product.

This unified endpoint places an order for one or more catalog items and works across all Hostinger products, leveraging the existing billing infrastructure. Use the catalog endpoint to look up the item_id values available for purchase.

If no payment method is provided, your default payment method will be used automatically.

If the response is 202 Accepted, the payment is still being processed and the order will complete asynchronously once the payment is confirmed.

This endpoint only places the order. Product-specific provisioning (e.g. VPS setup or domain registration) is not performed here — once the order completes, use the relevant product endpoints or hPanel to finalize setup.

Use this endpoint to purchase any product available in the catalog.

Authorizations

AuthorizationstringRequired

API Token authentication

Body

payment_method_idintegerOptional

Payment method ID, default will be used if not provided

Example: 1327362

Responses

200

Success response

application/json

idintegerOptional

Order ID

Example: 2957086

subscription_idstringOptional

Subscription ID

Example: Azz353Uhl1xC54pR0

statusstring · enumOptionalExample: completedPossible values:

currencystringOptional

Currency code

Example: USD

subtotalintegerOptional

Subtotal price (exc. VAT) in cents

Example: 899

totalintegerOptional

Total price (inc. VAT) in cents

Example: 1088

created_atstring · date-timeOptionalExample: 2025-02-27T11:54:22Z

updated_atstring · date-timeOptionalExample: 2025-03-27T11:54:22Z

202

Payment is being processed, the order will complete asynchronously

application/json

401

Unauthenticated response

application/json

422

Validation error response

application/json

500

Error response

application/json

post/api/billing/v1/orders

POST /api/billing/v1/orders HTTP/1.1
Host: developers.hostinger.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 108

{
  "payment_method_id": 1327362,
  "items": [
    {
      "item_id": "hostingercom-vps-kvm2-usd-1m",
      "quantity": 1
    }
  ],
  "coupons": []
}

{
  "id": 2957086,
  "subscription_id": "Azz353Uhl1xC54pR0",
  "status": "completed",
  "currency": "USD",
  "subtotal": 899,
  "total": 1088,
  "billing_address": {
    "first_name": "John",
    "last_name": "Doe",
    "company": null,
    "address_1": null,
    "address_2": null,
    "city": null,
    "state": null,
    "zip": null,
    "country": "NL",
    "phone": null,
    "email": "[e-mail]"
  },
  "created_at": "2025-02-27T11:54:22Z",
  "updated_at": "2025-03-27T11:54:22Z"
}