billing_createServiceOrderV1

Create a new service order for hosting services by specifying payment method, items, and optional coupons. Orders are set for automatic renewal. Use alternative payment methods to avoid credit card verification issues.

Instructions

Create a new service order.

DEPRECATED

To purchase a domain, use POST /api/domains/v1/portfolio instead.

To purchase a VPS, use POST /api/vps/v1/virtual-machines instead.

To place order, you need to provide payment method ID and list of price items from the catalog endpoint together with quantity. Coupons also can be provided during order creation.

Orders created using this endpoint will be set for automatic renewal.

Some credit_card payments might need additional verification, rendering purchase unprocessed. We recommend use other payment methods than credit_card if you encounter this issue.

Input Schema

Name	Required	Description
`coupons`	No	Discount coupon codes
`items`	Yes	items parameter
`payment_method_id`	Yes	Payment method ID

Input Schema (JSON Schema)

{
  "properties": {
    "coupons": {
      "description": "Discount coupon codes",
      "items": {
        "description": "coupons parameter",
        "type": "string"
      },
      "type": "array"
    },
    "items": {
      "description": "items parameter",
      "items": {
        "description": "items parameter",
        "properties": {
          "item_id": {
            "description": "Price Item ID",
            "type": "string"
          },
          "quantity": {
            "description": "quantity parameter",
            "type": "integer"
          }
        },
        "required": [
          "item_id",
          "quantity"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "payment_method_id": {
      "description": "Payment method ID",
      "type": "integer"
    }
  },
  "required": [
    "payment_method_id",
    "items"
  ],
  "type": "object"
}

hostinger-api-mcp