---
title: "Start Stripe Connect seller onboarding for the authenticated tenant"
method: POST
path: "/v1/payments/connect/onboarding/start"
tags: ["billing"]
---

# Start Stripe Connect seller onboarding for the authenticated tenant

`POST /v1/payments/connect/onboarding/start`

## Request

- Base URL: `https://api.runx.ai`
- URL: `https://api.runx.ai/v1/payments/connect/onboarding/start`
- Auth: HTTP bearer

## Request body

- StripeConnectOnboardingStartRequest
  - `refresh_url` string, uri, required
  - `return_url` string, uri, required
  - `seller_principal_id` string
  - `email` string
  - `country` string

## Response `200`

Stripe Connect onboarding URL.

- StripeConnectOnboardingStartEnvelope
  - `ok` unknown, required
  - `onboarding_url` string, uri, required
  - `expires_at` union, required
    - integer
    - string
  - `seller` StripeConnectSeller, required
    - `principal_id` string, required
    - `stripe_account_id` string, required
    - `charges_enabled` boolean, required
    - `payouts_enabled` boolean, required
    - `details_submitted` boolean, required
    - `status` 'pending' | 'enabled' | 'restricted', required
    - `registered_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `400`: Validation error.
- `401`: Unauthorized.
- `503`: Stripe Connect onboarding is not configured.

---

[API](https://skmtc.dev/runx/apis/runx-hosted-api.md) · [All operations](https://skmtc.dev/runx/apis/runx-hosted-api/llms.txt) · [OpenAPI document](https://skmtc.dev/runx/apis/runx-hosted-api/revisions/6c940d8edacc?raw)