> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Stripe Payments Integration
> Learn how to add payments and subscriptions to your app with Stripe using Agent.
export const AiPrompt = ({children}) => {
return
{children}
;
};
The Stripe Connector is only supported for Starter, Core, and Pro users. It is not available in Team Workspaces at this time.
## What you can build
Use Agent to add Stripe to your app in one click—no setup required. Build a storefront, accept one‑time payments, or create subscriptions. Agent wires up the integration, data models, and test environment.
## How it works
Agent starts with a Stripe sandbox so you can safely test payments without moving real money. You can build and try flows immediately. When you are ready, switch to your live Stripe account to publish and accept real payments.
A Stripe sandbox is an isolated test environment where you can simulate
payments, subscriptions, and events. Learn more in
[Stripe's docs on sandboxes](https://docs.stripe.com/sandboxes).
## Get started
* **Ask Agent to use Stripe**
* Use a slash command on the home screen and select Stripe, or ask directly:
Build a storefront and integrate Stripe for payments
Stripe integration requires an App with backend functionality. Select **App** from the homepage to get started.
## Test payments in the sandbox
1. Open your app’s **Preview** in a new tab.
2. Make a test purchase from your storefront or payment page.
3. Use Stripe’s standard test card:
```text theme={null}
Card number: 4242 4242 4242 4242
Expiry: any future date
CVC: any 3 digits
Name, address: any mock values
```
Sandbox purchases don’t process through real networks or move money. They’re
safe for testing end to end.
## Manage products and pricing
You have two options:
1. From your app, select **Publish**, then choose to claim your Stripe sandbox.
* If you don’t have a Stripe account yet, create one to claim the sandbox.
2. In the Stripe Dashboard, open **Products** to add or edit products and prices.
Changes you make in the Stripe sandbox reflect in your Replit app automatically
and sync to your app’s database.
### View synced Stripe data
* In the Project Editor, open **Database**.
* Select **MyData**.
* Change the schema selector to **Stripe** to see payment objects and related
records.
## Go live
To accept real payments:
Before you publish:
* Install the [Replit Integrated Payments](https://marketplace.stripe.com/apps/replit-integrated-payments) app in your live Stripe account
(required for sandbox‑to‑live synchronization)
* Complete Stripe’s KYB verification and add your live API keys
Your sandbox integration is not production‑ready. It cannot accept real
payments until you complete these steps.
1. In Stripe, switch from sandbox to your live account.
2. Complete Stripe’s KYB (Know Your Business) verification if prompted.
3. Copy your live Publishable and Secret keys from Stripe.
4. In Replit, open the **Publish** pane, then add your live keys.
5. Publish your app.
## Manage the integration
* Go to **Integrations > Stripe** to open the Stripe connector.
* From there, you can test the connection, view status, and manage settings.
## Frequently asked questions
### How do I update the prices of my products?
* Ask Agent: Describe the change and Agent updates your app and Stripe objects.
* Use the Stripe Dashboard: Open **Products** to edit prices and product details.
* In sandbox, changes sync back to your app and database automatically.
* For production, switch to your live account first, then update prices. Publish again if your app needs to pick up new configuration.
### How do I test transactions on Replit?
Open your app’s **Preview** in a new tab. Run the Stripe Checkout flow with the
standard test card (4242 4242 4242 4242), any future expiry, and any CVC. See
[Test payments in the sandbox](#test-payments-in-the-sandbox) above for details.
### What is a live Stripe account?
A live Stripe account is an activated and verified account that can process real
payments using your business details. See Stripe’s guidance on account creation
and activation: [Create and manage your Stripe account](https://docs.stripe.com/get-started/account).
### How do I find my live keys?
1. In the Stripe Dashboard, switch to your live account using the account picker (top left).
2. From the bottom left, select **Developers** > **API keys**.
3. Reveal your live keys or create new ones. For step‑by‑step instructions on creating new keys, see
[Create a secret API key](https://docs.stripe.com/keys#create-api-secret-key).
## Update or remove the Stripe connection
If you're not ready to publish with your Stripe live keys, you have three options:
### Option A: Use placeholder API keys
You can use Stripe placeholder keys that you can replace later.
Placeholder keys will not process real payments. The catalog and checkout will not function on your published URL until you add your live Stripe keys. Use this option only for testing purposes.
Open the **Publish** pane in the Project Editor.
Use these values:
**Publishable Key:**
```text theme={null}
pk_live_abcdef
```
**Secret Key:**
```text theme={null}
sk_live_abcdef
```
### Option B: Remove the Stripe integration manually
You can completely remove the Stripe integration from your project.
Navigate to the project with the Stripe integration you want to remove.
This opens the connection details.
Go to Agent chat and ask Agent to remove the Stripe connector code from your application. This will remove your entire Stripe integration.
### Option C: Roll back to a checkpoint before the Stripe integration
If you want to completely undo the Stripe integration and return to a previous state, you can roll back to an earlier checkpoint.
Navigate to the project with the Stripe integration you want to remove.
This opens the connection details.
Go to Agent chat and look for a checkpoint that was created before the Stripe integration. Select the **clock icon** on the top left of the chat pane to view older chat history.
Once you find a checkpoint that looks good, select **Rollback here** to restore your project to that state.
## Notes and limitations
* Sandbox activity does not affect real balances or customers.
* Some Stripe features can't be tested in sandboxes (for example, IC+ pricing
and certain Connect flows). See
[Stripe's sandbox limitations](https://docs.stripe.com/sandboxes).