Setup Payment Method

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

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

Billing

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:

Frontend calls this endpoint
Backend creates Stripe Customer (if needed) and SetupIntent
Frontend uses client_secret with Stripe Elements
User enters card details
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

organizations

billing

setup-payment-method

Setup Payment Method

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

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

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

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"

Update Spending Caps Confirm Payment Method