---
title: "Install Stripe integration"
method: POST
path: "/api/apps/{app_id}/payments/stripe/install"
---

# Install Stripe integration

`POST /api/apps/{app_id}/payments/stripe/install`

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

Sets up a Stripe [sandbox](/developers/references/apps-api/sections/payments-stripe#from-sandbox-to-live) for the app and stores test credentials.

Calling this again when the app already has a usable Stripe installation returns the existing installation instead of creating a duplicate.

If the app has a Wix store, that store already owns the app's checkout and this call is blocked, since a store and a payment provider can't both own it. Payment providers don't enforce that same exclusivity against each other, though. An active Wix Payments or Payments by Wix connection doesn't block this call, and installing Stripe alongside such a connection leaves both connected.

Requires write access to the app. Workspace viewers cannot call this operation.

## Path parameters

- `app_id` string, required — ID of the Base44 app.

## Response `200`

Successful Response

- InstallStripeResponse — Response for Stripe installation.
  - `already_installed` boolean — Whether an existing usable installation was reused. Defaults to `false`.
  - `claim_url` string, nullable — Stripe onboarding link, or `null` when no claim step is available. Treat this link as a credential. Defaults to `null`.

## Other responses

- `401` — Missing or invalid credentials.
- `403` — The credential is not permitted or you don't have the required app access. A missing app also fails the app access check.
- `404` — The app is outside the credential's granted workspace.
- `409` — Another installation is in progress, a Wix store already owns the app's checkout, or the workspace requires an unlocked SSO session.

## Changes

- **2026-09-15** `ca10c5ce328c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/base44/apis/base44-app-management-api/changes/api/apps/:app_id/payments/stripe/install/post.md)

---

[API](https://skmtc.dev/base44/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/base44/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/base44/apis/base44-app-management-api/revisions/cf164639a9bf?raw)