Valstorm LogoDev

stripe Endpoints

All endpoints for the stripe API group. Great for feeding into an LLM context.

GET

/v1/stripe/public/auth/callback

Stripe Auth Callback

Handles the OAuth2 callback from Stripe Apps. Exchanges the authorization code for Stripe Connect tokens, optionally verifies the install signature if provided, and stores credentials. Supports both Valstorm-led flows and Stripe-led Redirect-to-Claim flows.

Parameters
code
in: query
type: any
user_id
in: query
type: any
account_id
in: query
type: any
stripe_user_id
in: query
type: any
install_signature
in: query
type: any
livemode
in: query
type: any
state
in: query
type: any
error
in: query
type: any
valstorm_user_id
in: query
type: any
valstorm_org_id
in: query
type: any
Responses
200
Stripe auth callback received successfully
application/json
{
  "$ref": "#/components/schemas/StripeAuthCallbackResponse"
}
400
Invalid request data
application/json
{
  "$ref": "#/components/schemas/StripeAuthErrorResponse"
}
404
Not found
422
Validation Error
application/json
{
  "$ref": "#/components/schemas/HTTPValidationError"
}
API Runner
POST

/v1/stripe/public/webhook

Stripe Webhook

Receives and routes Stripe Connect/App webhook events.

Responses
200
Successful Response
application/json
{}
404
Not found
API Runner
POST

/v1/stripe/fetch

Stripe Fetch Proxy

Authenticated generic proxy endpoint that maps API requests to standard multi-tenant Stripe operations in PlatformContext.

Request Body
{
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StripeFetchRequest"
      }
    }
  },
  "required": true
}
Responses
200
Successful Response
application/json
{}
404
Not found
422
Validation Error
application/json
{
  "$ref": "#/components/schemas/HTTPValidationError"
}
API Runner
POST

/v1/stripe/sync/historical

Trigger Historical Sync

Authenticated endpoint that enqueues a background task to sync all historical Stripe Products, Prices, Customers, Invoices, and nested Line Items from scratch.

Responses
200
Successful Response
application/json
{}
404
Not found
API Runner
GET

/v1/stripe/auth/login

Login Stripe

Initiates the Stripe OAuth / App installation flow by generating a unique state, storing it in Redis, and redirecting the user to the installation link.

Responses
200
Successful Response
application/json
{}
404
Not found
API Runner
POST

/v1/stripe/auth/claim

Claim Stripe Credentials

Claims previously cached Stripe credentials using a secure claim token and links them to the logged-in Valstorm user's database.

Request Body
{
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StripeClaimRequest"
      }
    }
  },
  "required": true
}
Responses
200
Successful Response
application/json
{}
404
Not found
422
Validation Error
application/json
{
  "$ref": "#/components/schemas/HTTPValidationError"
}
API Runner