Skip to main content
GET
Get Stripe integration status

Authorizations

api_key
string
header
required

Personal API key.

Path Parameters

app_id
string
required

ID of the Base44 app.

Query Parameters

check_transactions
boolean
default:false

Whether to look for any checkout session in sandbox mode. Defaults to false. A session does not prove payment, and lookup failures report false.

Response

Successful Response

Comprehensive Stripe integration status response.

app_id
string
required

ID of the Base44 app.

Example:

"6820f3a4e7b91d003c45a1f2"

stripe_mode
string | null

Mode inferred from available credentials and sandbox state. Either sandbox or live, or null when neither is available. Defaults to null.

Example:

"sandbox"

sandbox_status
string | null

Stored sandbox status. Either unclaimed, claimed, or expired, or null without a sandbox. Defaults to null.

Example:

"unclaimed"

sandbox_is_claimable
boolean
default:false

Whether the sandbox is unclaimed, has not expired, and has a stored claim link. Defaults to false.

Example:

true

sandbox_claim_url
string | null

Stored claim link, or null when the sandbox is not claimable or you are a workspace viewer. Treat this link as a credential. Defaults to null.

Example:

"https://dashboard.stripe.com/claim/example"

sandbox_days_until_expiry
integer | null

Whole days until sandbox expiration, or null for a claimed sandbox or when no expiration is stored. Defaults to null.

Example:

30

sandbox_account_id
string | null

Stripe sandbox account ID, or null without a sandbox. Defaults to null.

Example:

"acct_T7mK2p9Q4r6S8v"

test_mode_configured
boolean
default:false

Whether test credentials are available. Defaults to false.

Example:

true

live_mode_configured
boolean
default:false

Whether live credentials or a connected live account are available. This alone does not mean the app has switched to live keys. Defaults to false.

Example:

false

live_mode_method
string | null

Available live authentication method. Either direct_keys or platform_auth, or null when neither is available. Direct keys take precedence. Defaults to null.

Example:

"direct_keys"

live_keys_configured
boolean
default:false

Stored completion flag for live key setup. Defaults to false.

Example:

false

live_account_id
string | null

Connected live Stripe account ID, or null before activation. Defaults to null.

Example:

"acct_L8nP3q5R7s9T2v"

has_tested_payment
boolean | null

Whether Stripe reports any checkout session when requested in sandbox mode. False also covers a failed lookup, and a session does not prove payment. Otherwise null. Defaults to null.

Example:

false