> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Stripe integration status

> <Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Reports how far Stripe setup has gone for the app, without returning any credentials.

It covers the [sandbox](/developers/references/apps-api/sections/payments-stripe#from-sandbox-to-live)'s status and claim state, and whether test or live credentials are stored.

If Stripe was never set up, every field but `app_id` comes back `false` or `null`.

Requires read access to the app.



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json get /api/apps/{app_id}/payments/stripe/status
openapi: 3.1.0
info:
  title: Base44 App Management API
  version: 1.0.0
servers:
  - url: https://app.base44.com
security:
  - PersonalAccessTokenAuth: []
paths:
  /api/apps/{app_id}/payments/stripe/status:
    get:
      summary: Get Stripe integration status
      description: >-
        <Info>This API is in beta. Endpoints, fields, and behavior may still
        change, so avoid depending on it in production.</Info>


        Reports how far Stripe setup has gone for the app, without returning any
        credentials.


        It covers the
        [sandbox](/developers/references/apps-api/sections/payments-stripe#from-sandbox-to-live)'s
        status and claim state, and whether test or live credentials are stored.


        If Stripe was never set up, every field but `app_id` comes back `false`
        or `null`.


        Requires read access to the app.
      operationId: >-
        get_stripe_integration_status_api_apps__app_id__payments_stripe_status_get
      parameters:
        - name: app_id
          in: path
          required: true
          schema:
            type: string
            description: ID of the Base44 app.
            title: App Id
          description: ID of the Base44 app.
          example: 6820f3a4e7b91d003c45a1f2
        - name: check_transactions
          in: query
          required: false
          schema:
            type: boolean
            description: >-
              Whether to look for any checkout session in sandbox mode. Defaults
              to `false`.
            default: false
            title: Check Transactions
          description: >-
            Whether to look for any checkout session in sandbox mode. Defaults
            to `false`.
          example: false
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StripeIntegrationStatusResponse'
        '401':
          description: Missing or invalid credentials.
        '403':
          description: >-
            The credential is not permitted or you don't have the required app
            access. A missing app also fails the app access check. Setup and
            catalog operations also return `app_payment_management_not_allowed`
            when the app's workspace restricts payment management.
        '404':
          description: The app is outside the credential's granted workspace.
        '409':
          description: The workspace requires an unlocked SSO session.
        '422':
          description: '`check_transactions` isn''t a valid boolean.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - PersonalAccessTokenAuth:
            - full_access
components:
  schemas:
    StripeIntegrationStatusResponse:
      properties:
        app_id:
          type: string
          title: App Id
          description: ID of the Base44 app.
          example: 6820f3a4e7b91d003c45a1f2
        stripe_mode:
          anyOf:
            - type: string
            - type: 'null'
          title: Stripe Mode
          description: >-
            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:
          anyOf:
            - type: string
            - type: 'null'
          title: Sandbox Status
          description: >-
            Stored sandbox status. Either `unclaimed`, `claimed`, or `expired`,
            or `null` without a sandbox. Defaults to `null`.
          example: unclaimed
        sandbox_is_claimable:
          type: boolean
          title: Sandbox Is Claimable
          description: >-
            Whether the sandbox is unclaimed, has not expired, has a stored
            claim link, and the app's workspace allows payment management.
            Defaults to `false`.
          default: false
          example: true
        sandbox_claim_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Sandbox Claim Url
          description: >-
            Stored claim link, or `null` when the sandbox is not claimable, you
            are a workspace viewer, or the app's workspace restricts payment
            management. Treat this link as a credential. Defaults to `null`.
          example: https://dashboard.stripe.com/claim/example
        sandbox_days_until_expiry:
          anyOf:
            - type: integer
            - type: 'null'
          title: Sandbox Days Until Expiry
          description: >-
            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:
          anyOf:
            - type: string
            - type: 'null'
          title: Sandbox Account Id
          description: >-
            Stripe sandbox account ID, or `null` without a sandbox. Defaults to
            `null`.
          example: acct_T7mK2p9Q4r6S8v
        test_mode_configured:
          type: boolean
          title: Test Mode Configured
          description: Whether test credentials are available. Defaults to `false`.
          default: false
          example: true
        live_mode_configured:
          type: boolean
          title: Live Mode Configured
          description: >-
            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`.
          default: false
          example: false
        live_mode_method:
          anyOf:
            - type: string
            - type: 'null'
          title: Live Mode Method
          description: >-
            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:
          type: boolean
          title: Live Keys Configured
          description: >-
            Whether live key setup finished completely, including the redeploy
            that picks up the new keys. A partial failure leaves this `false`
            even after keys are stored. Defaults to `false`.
          default: false
          example: false
        live_account_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Live Account Id
          description: >-
            Connected live Stripe account ID, or `null` before activation.
            Defaults to `null`.
          example: acct_L8nP3q5R7s9T2v
        has_tested_payment:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Has Tested Payment
          description: >-
            Whether Stripe reports any checkout session when requested in
            sandbox mode. A failed lookup also reports `false`, and a session
            does not prove payment. Otherwise `null`. Defaults to `null`.
          example: false
      type: object
      required:
        - app_id
      title: StripeIntegrationStatusResponse
      description: Comprehensive Stripe integration status response.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    PersonalAccessTokenAuth:
      type: http
      scheme: bearer
      description: >-
        Personal access token, sent as `Authorization: Bearer <token>`. Each
        operation lists the permission it needs: `read_only` or `full_access`. A
        full-access token can call every operation. A read-only token can call
        only the operations that list `read_only`; anything else returns 403
        `read_only_credential_route_not_allowed`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.