---
title: "Begin Stripe Connect onboarding"
method: GET
path: "/credits/connect/stripe/authorize"
tags: ["Ledger"]
---

# Begin Stripe Connect onboarding

`GET /credits/connect/stripe/authorize`

## Request

- Base URL: `https://api.paywithlocus.com/api`
- URL: `https://api.paywithlocus.com/api/credits/connect/stripe/authorize`
- Auth: HTTP bearer

Returns the Stripe consent URL to send a workspace owner or admin to. Dashboard-only: a tenant secret key cannot start this flow, and evaluation workspaces are refused until a commercial agreement is active. Requires an owner or admin with MFA step-up completed in the last ten minutes.

## Query parameters

- `returnTo` string

## Headers

- `X-Locus-Step-Up` string, password

## Response `200`

Consent URL

- object
  - `success` unknown, required
  - `url` string, uri, required

## Other responses

- `403`: STEP_UP_REQUIRED, a non-Cognito principal, INSUFFICIENT_SCOPE, or payouts locked for an evaluation workspace.

---

[API](https://skmtc.dev/paywithlocus/apis/locus-pro-api.md) - [All operations](https://skmtc.dev/paywithlocus/apis/locus-pro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paywithlocus/apis/locus-pro-api/revisions/aab8fa5d6cef?raw)