Checkouts2026.8.0

Create Stripe Checkout session for domain purchase

Validates domain availability, calculates pricing, and creates a Stripe Checkout session for the requested domain and add-ons.

POST/api/v1/billing/checkout/domains

The source export uses a local development server. Examples use the configured Dashio API origin.

The export references authentication schemes without supplying their definitions.

Authentication

bearerAuth

Understand authentication

Path parameters

None declared in this export.

Query parameters

None declared in this export.

Header parameters

None declared in this export.

Request body

application/json · Required

domainstringRequired

Fully qualified domain to purchase.

billingIntervalstringRequired

Allowed values: "monthly", "yearly".

addonsobjectRequired

No field description supplied.

contactobjectRequired

No field description supplied.

accountTypestringRequired

Allowed values: "private", "business".

companystringOptional

No field description supplied.

emailstring (email)Required

No field description supplied.

firstNamestringRequired

No field description supplied.

lastNamestringRequired

No field description supplied.

phoneobjectRequired

No field description supplied.

streetstringRequired

No field description supplied.

zipstringRequired

No field description supplied.

citystringRequired

No field description supplied.

countrystringRequired

No field description supplied.

successUrlstring (uri)Required

No field description supplied.

cancelUrlstring (uri)Required

No field description supplied.

Request & response examples

Copy an example in your preferred language.

request.sh

curl --request POST 'https://dashio.net/api/v1/billing/checkout/domains' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "domain": "<domain>",
  "billingInterval": "monthly",
  "addons": "<addons>",
  "contact": {
    "accountType": "private",
    "email": "<email>",
    "firstName": "<firstName>",
    "lastName": "<lastName>",
    "phone": {
      "countryCode": "<countryCode>",
      "areaCode": "<areaCode>",
      "subscriberNumber": "<subscriberNumber>",
      "e164": "<e164>"
    },
    "street": "<street>",
    "zip": "<zip>",
    "city": "<city>",
    "country": "<country>"
  },
  "successUrl": "<successUrl>",
  "cancelUrl": "<cancelUrl>"
}'

Replace URL parameters, credentials, and schema placeholders before running. No request is sent by this page.

Schema-generated example; not a captured response.

{
  "productFamily": "domains"
}

Examples use the configured API origin. Replace credentials, URL parameters, and schema placeholders before running.

Responses

200

Stripe Checkout session created.

sessionIdstringOptional: No field description supplied.
checkoutUrlstring (uri)Optional: No field description supplied.
productFamilystringRequired: Allowed values: "domains".

400

Invalid domain, contact details, or redirect URLs.

No response body schema supplied.

401

Unauthenticated.

No response body schema supplied.

403

Forbidden. User is not owner or admin of the space.

No response body schema supplied.

409

Domain is no longer available.

No response body schema supplied.

500

Failed to create Stripe checkout session.

No response body schema supplied.

Was this helpful?