Setup Payment Method

Initialize payment method setup flow.

Creates a Stripe SetupIntent for collecting payment method without charging. The client_secret should be used with Stripe Elements on the frontend.

Flow:

1. Frontend calls this endpoint
2. Backend creates Stripe Customer (if needed) and SetupIntent
3. Frontend uses client_secret with Stripe Elements
4. User enters card details
5. Frontend calls confirm-payment-method endpoint

Requirements:

• Admin permission (only org admins can set up payment methods)

Example:

response = await client.post("/v1/organizations/billing/setup-payment-method")
client_secret = response["client_secret"]
# Use client_secret with Stripe Elements

POST /v1/organizations/billing/setup-payment-method

Setup Payment Method

cURL

curl --request POST \
  --url https://api.mixpeek.com/v1/organizations/billing/setup-payment-method \
  --header 'Authorization: Bearer <token>'

200

{
  "setup_intent_id": "<string>",
  "client_secret": "<string>",
  "customer_id": "<string>"
}

Authorizations

Authorization · string · header · required

Mixpeek API key, sent as Authorization: Bearer mxp_sk_.... Create one in Studio under Settings → API Keys, or with an admin key via POST /v1/organizations/users/{user_email}/api-keys. A missing header returns 403; an invalid or revoked key returns 401.

Response

200

application/json

Successful Response

Response after creating a SetupIntent.

setup_intent_id · string · required

Stripe SetupIntent ID

Example:

"seti_1ABC2DEF3GHI"

client_secret · string · required

Client secret for Stripe Elements

Example:

"seti_1ABC2DEF3GHI_secret_XYZ"

customer_id · string · required

Stripe Customer ID

Example:

"cus_ABC123DEF456"