Checkouts2026.8.0

Create Stripe Checkout session for SaaS plan subscription

Creates a recurring Stripe subscription checkout session for the selected SaaS plan and seat count.

POST/api/v1/billing/checkout/saas

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

planIdstringRequired

Allowed values: "startup", "business", "enterprise".

seatsintegerRequired

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/saas' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "planId": "startup",
  "seats": 0,
  "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": "saas"
}

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: "saas".

400

Invalid plan selection, seat count, or contact information.

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.

500

Failed to create Stripe checkout session.

No response body schema supplied.

Was this helpful?