Sell through agentsFrontier

To get set up for agentic commerce:

1. First, you need a Stripe account. Create an account.
2. After you create an account:
   • Verify your email.
   • Activate payments by providing business and personal information.
   • Connect a bank account for payouts.
   • Set up two-factor authentication.

1. Go to the Agentic commerce page in the Dashboard and select Get started on Agentic commerce for retail, then choose to onboard as a seller.
2. In the modal, populate your business details by creating a Stripe profile. Add your terms of service, privacy policy, and return policy.
3. Configure tax. Stripe calculates tax at checkout using the values in your catalog feed, and incomplete configuration can cause checkouts to fail. Configure a tax code for each taxable product. Stripe Tax is optional: set stripe_product_tax_code if you use Stripe Tax for automatic tax calculation (follow the tax setup guide to configure it), or set third_party_tax_code if you use Anrok instead. See the price and promotions field reference for details on these fields.

Create a catalog feed to share your product and inventory data with agents. Format your feed as a CSV where each row is a product or variant and each column maps to a field in the product feed field reference.

After you set up your catalog feed, follow these suggested best practices to prevent issues with outdated inventory or pricing. For example, agents might continue to report that a product isnt available (even if its back in stock) until they receive an explicit signal that the inventory has been updated.

To troubleshoot continued issues, see how to Handle out-of-stock and price failures.

Keep your catalog feed current

To prevent purchase failures during agentic checkout, refresh your product catalog feed frequently. How frequently depends on how fast your inventory moves, but in most cases, uploading inventory and pricing data every 15 minutes is enough.

Between full uploads, send targeted changes with the incremental inventory and incremental price feeds instead of re-uploading your entire catalog.

Cleanly remove old products

When you remove a product from your inventory, send a clean deletion. In upsert mode, omitting a product from your feed leaves it unchanged in Stripes catalog. To explicitly remove it, set delete=true. Otherwise, the product remains visible to shoppers and agents.

Only use replace mode for complete inventory refreshes

Feed uploads support two processing modes: upsert and replace. In replace mode, any product not included in the uploaded file is permanently deleted from Stripes catalog. Use upsert for all incremental updates and reserve replace mode for intentional full-catalog refreshes. See Feed processing mode.

curl -X POST https://api.stripe.com/v2/commerce/product_catalog/imports \
  -H "Authorization: Bearer sk_test_wU7nrJCZspk1NPDxiQgAF05q" \
  -H "Stripe-Version: 2026-07-29.preview" \
  --json '{
    "feed_type": "product",
    "mode": "upsert",
    "metadata": {
        "file_name": "march_11_2026_product_upload.csv"
    }
  }'

{
  "id": "pcimprt_xxx",
  "object": "v2.commerce.product_catalog_import",
  "created": "2026-03-26T00:35:01.000Z",
  "feed_type": "product",
  "status": "awaiting_upload",
  "status_details": {
    "awaiting_upload": {
      "upload_url": {
        "expires_at": "2026-03-26T00:40:02.000Z",
        "url": "https://stripeusercontent.com/files/us-west-2/upload/wksp_xxx"
      }
    }
  },
  "livemode": true
}

curl -X PUT \
  -H "Content-Type: text/csv" \
  --data-binary @"/path/to/your/file.csv" \
  "{{PRESIGNED_URL}}"

Stripe processes your product data, validates and cleans it, then indexes it in a format you can send to AI agents. We recommend listening for webhook events so youre notified as soon as indexing completes, instead of polling for status. You can monitor indexing progress in two ways:

{
  "id": "evt_65THl3VA5Zt5cTqbP16T9R4DRrSQbEWmWeLUx7WmOR8B",
  "object": "v2.core.event",
  "type": "v2.commerce.product_catalog.imports.succeeded",
  "created": "2026-03-26T00:40:00.000Z",
  "livemode": true,
  "reason": null,
  "related_object": {
    "id": "pcimprt_61THl3VA5Zt5cTqbP16T9R4DRrSQbEWmWeLUx7WmOR8K",
    "type": "v2.commerce.product_catalog.imports",
    "url": "/v2/commerce/product_catalog/imports/pcimprt_61THl3VA5Zt5cTqbP16T9R4DRrSQbEWmWeLUx7WmOR8K"
  },
  "changes": {
    "before": {"status": "PROCESSING"},
    "after": {"status": "SUCCEEDED"}
  },
  "data": {}
}

curl https://api.stripe.com/v2/commerce/product_catalog/imports/
{{PRODUCT_CATALOG_IMPORT_ID}} \
  -H "Authorization: Bearer sk_test_wU7nrJCZspk1NPDxiQgAF05q" \
  -H "Stripe-Version: 2026-07-29.preview"

Keeping inventory current is required to prevent checkout failures. Send incremental inventory updates through the Imports API. Use the same upload process as product data uploads, but set feed_type to inventory. Inventory feeds support only upsert mode. See the inventory feed specification for the required fields.

curl -X POST https://api.stripe.com/v2/commerce/product_catalog/imports \
  -H "Authorization: Bearer sk_test_wU7nrJCZspk1NPDxiQgAF05q" \
  -H "Stripe-Version: 2026-07-29.preview" \
  --json '{
    "feed_type": "inventory",
    "mode": "upsert",
    "metadata": {
        "file_name": "march_11_2026_inventory_upload.csv"
    }
  }'

Keeping prices current is required to prevent checkout failures. Send incremental price updates through the Imports API. Use the same upload process as product data uploads and set feed_type to pricing. Price feeds support only upsert mode. See the price feed specification for the required fields.

curl -X POST https://api.stripe.com/v2/commerce/product_catalog/imports \
  -H "Authorization: Bearer sk_test_wU7nrJCZspk1NPDxiQgAF05q" \
  -H "Stripe-Version: 2026-07-29.preview" \
  --json '{
    "feed_type": "pricing",
    "mode": "upsert",
    "metadata": {
        "file_name": "march_11_2026_pricing_upload.csv"
    }
  }'

Price mismatches, where the price shown to a shopper doesnt match the price we charge, cause checkouts to fail. To keep the checkout price aligned with the quoted price:

• Upload pricing feeds as soon as prices change, not on a scheduled delay.
• sale_price_effective_date is required when you set a sale_price. Stripe uses the end date to stop applying the sale price automatically, with no feed update needed.
• If the product price and availability hook returns a different price or sale_price than your feed, the hook value takes precedence.

When youre ready to sell through an AI interface:

1. Go to the Agentic commerce page in the Dashboard.
2. Find the agent you want to sell through and review its terms.
3. Click the overflow menu (), then select Request connection.

We send the agent an approval request that the agent must accept. When the connection succeeds, the agents Status column shows Enabled. To pause or stop selling on an AI chat agent, disable it on the same page.

Monitor orders placed through AI chat agents in three ways.

const stripe = require('stripe')(process.env.STRIPE_SECRET_KEY);

// Use the secret provided by Stripe CLI for local testing
// or your webhook endpoint's secret
const endpointSecret = 'whsec_...';

app.post('/webhook', (request, response) => {
  const sig = request.headers['stripe-signature'];
  let event;

  try {
    event = stripe.webhooks.constructEvent(request.body, sig, endpointSecret);
  } catch (err) {
    response.status(400).send(`Webhook Error: ${err.message}`);
    return;
  }

  if (event.type === 'checkout.session.completed') {
    const session = event.data.object;
    // Fulfill the order using the session data
    fulfillCheckout(session.id);
  }

  response.status(200).send();
});

{
  "id": "evt_1SUz6YRhxngcl2jFHhAi1Wiu",
  "object": "event",
  "api_version": "2025-10-29.clover",
  "created": 1763511518,
  "data": {
    "object": {
      "id": "cs_test_a1exHOZ77Pg40P1hPtcWe2oT2xI8G9ruoQohXq6jkKldIPQaGsNSPQmOGZ",
      "object": "checkout.session",
       ...
      "total_details": {
        "amount_discount": 0,
        "amount_shipping": 0,
        "amount_tax": 0
      }
    }
  },
  "livemode": false,
  ...
  "type": "checkout.session.completed"
}

curl https://api.stripe.com/v1/checkout/sessions/{{SESSION_ID}}?expand[]=line_items.data.price.product&expand[]=line_items.data.taxes&expand[]=payment_intent.latest_charge \
  -u sk_test_wU7nrJCZspk1NPDxiQgAF05q: \
  -H "Stripe-Version: 2025-12-15.preview"

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

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

After your core integration is live, use these optional guides to refine your setup:

• Set up manual capture: Capture payments manually instead of immediately after purchase.
• Set up hooks: Configure order approval, checkout customization, and product price and availability hooks.
• Handle out-of-stock and price failures: Keep checkouts from failing when inventory or prices change between feed refreshes.
• Add promotions to drive conversion: Offer discount codes, deals, and free shipping through agents.
• Handle refunds and disputes: Manage cancellations, refunds, and disputes for agentic checkouts.
• Export your catalog feed: Export a snapshot of the catalog feed you imported into Stripe.