Skip to content
Create account or Sign in
The Stripe Docs logo
/
Create accountSign in
OverviewAccept a paymentUpgrade your integration
Online payments
OverviewFind your use caseRecurring payments
In-person payments
Payment methods
Payment operations
Balances and settlement timeReceiptsRefunds and cancellations
Advanced integrations
Beyond payments

Enable in-context selling on AI agentsPrivate preview

Learn how to start selling your products in-context using AI agents.

Private preview

If your business wants to use agentic commerce to sell products, join the waitlist.

Note

Use this guide if you run an e-commerce business. If you operate a marketplace and want to offer in-context agentic selling on your platform, see our guide for platforms and marketplaces.

Set up your Stripe account

If you don’t already have a Stripe account, create one. After you verify your email, activate payments by providing business and personal information, linking a bank account for payouts, and setting up two-step authentication. Then, go to Agentic Commerce Onboarding in the Stripe Dashboard. This guides you through creating a Stripe Profile and configuring settings for agentic commerce.

Configure taxes

Use Stripe Tax to manage taxes and apply configurations to individual products. Follow the tax setup guide to configure Stripe Tax. In your product catalog CSV upload, set the stripe_product_tax_code column to associate a product with a tax treatment. Stripe also supports tax calculations by third-party tax providers, including Anrok, Avalara, and Sphere.

Upload your product catalog data to Stripe

Create a CSV file that conforms to the Stripe product catalog spec.

Upload the catalog data to Stripe

Send the feed in the Stripe Dashboard or through the Stripe API. You can upload feeds at whatever interval you choose. To keep data current, upload product data once per day and send more frequent incremental updates for inventory and pricing.

Note

Feed uploads are processed as independent, asynchronous tasks. We don’t guarantee uploads are processed or completed in the order you submit them. If you upload multiple files in quick succession, a later upload can finish before an earlier one.

Use Stripe APIs to upload your product catalog CSV. We recommend using the sandbox to validate parsing, field mappings, and data quality before enabling live updates.

First, upload your product catalog CSV using the Files API. A successful request returns a File object, which includes the id.

  • Specify the data_management_manual_upload purpose.
  • The MIME type of the file upload must match its file format. Acceptable formats include CSV and TSV, where each row represents one product or variant.
  • The maximum file size is 200 MB.
Command Line
curl https://files.stripe.com/v1/files \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -F purpose=data_management_manual_upload \
  -F file="@/path/to/your/file.csv;type=text/csv"

Then, use the Data Management API to create an ImportSet. This call starts catalog processing and makes the data available in the Dashboard. Include the following:

  • The file id that the Files API returned.
  • The preview header (for example, Stripe-Version: 2025-09-30.clover;udap_beta=v1).
Command Line
curl https://api.stripe.com/v1/data_management/import_sets \
  -H "Stripe-Version: 2025-09-30.clover;udap_beta=v1" \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d file={{FILE_ID}} \
  --data-urlencode standard_data_format="product_catalog_feed"

Monitor feed status and resolve errors

Stripe processes your catalog data, validates and cleans it, then indexes it in a format you can send to AI agents. You can monitor indexing progress in two ways:

Make a GET request and check the status field on the ImportSet object. The status can be pending, failed, succeeded, succeeded_with_errors, pending_archive, or archived.

Command Line
curl https://api.stripe.com/v1/data_management/import_sets/{{IMPORT_SET_ID}} \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:

The response includes the status and any errors:

{
  "id": "impset_7MabcdZ8b617780e5145413",
  "object": "data_management.import_set",
  "created": 1643992696,
  "livemode": true,
  "result": {
    "errors": {
      "file": "file_234923sIENc",
      "row_count": 30
    },
    "rows_processed": 120,
    "successes": {
      "row_count": 90
    }
  },
  "status": "succeeded_with_errors"
}

If your import status is succeeded_with_errors, you can download the error report.

  1. Look for the result.errors.file field in the response.
  2. Use the Files API to retrieve the content of the error file using the file ID.
  3. The downloaded CSV file contains your original data with a leading column named stripe_error_message that describes why each row failed.
Command Line
curl https://files.stripe.com/v1/files/{{ERROR_FILE_ID}}/contents \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:

The API returns a CSV file containing only the rows that failed, with a stripe_error_message column describing each error.

Respond to purchases and fulfill orders

Monitor orders placed through AI chat agents in three ways.

View orders on the Transactions page in the Dashboard—they’re tagged with the originating agent.

Enable sales on an AI chat agent

When you’re ready to sell on an AI chat agent, review the agent terms and enable the agent in the Stripe Dashboard. Stripe sends the agent an approval request that the agent must accept. To pause or stop selling on an AI chat agent, disable the agent in the Dashboard.

Test your integration

You can test your integration directly from the Dashboard in a sandbox:

  1. Go to the Agentic Commerce page, then click View catalog.
  2. Hover over the product you want to test, then click Test in Workbench.

See also