Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Revenue
Platforms and marketplaces
Money management
Developer resources
Overview
Versioning
Changelog
Upgrade your API version
Upgrade your SDK version
Essentials
SDKs
    Overview
    Server-side SDKs
    Web
    ES Module Stripe.js
    React Stripe.js
    Stripe.js test mode assistant
    Mobile
    iOS SDK
    Android SDK
    React Native SDK
    Migrate to iOS SDK 24
    Migrate to Android SDK 21
    Terminal
    iOS SDK
    Android SDK
    React Native SDK
    Community
    Community SDKs
API
Testing
Stripe CLI
Sample projects
Tools
Stripe Dashboard
Workbench
Developers Dashboard
Stripe Shell
Stripe for Visual Studio Code
Features
Workflows
Event destinations
Stripe health alertsFile uploads
AI solutions
Agent toolkit
Model Context ProtocolBuild agentic AI SaaS Billing workflows
Security and privacy
Security
Stripebot web crawler
Privacy
Extend Stripe
Build Stripe apps
Use apps from Stripe
Partners
Partner ecosystem
Partner certification
HomeDeveloper resourcesSDKs

Stripe.js test mode assistant

Test and debug your Elements integration directly on your website using your browser.

You can use the Stripe.js test mode assistant to set up your integration.

The test mode assistant in the browser

The test mode assistant appears on the bottom right of the page.

The test mode assistant appears on your website on any page with Elements loaded in test mode and doesn’t appear in live mode. The test mode assistant provides tools that allow you to:

  • Provide autofill shortcuts for payment methods and payment scenarios
  • Highlight integration errors, warnings, and optimizations
  • Simulate your customer’s location to see which payment methods you display to customers around the world

Elements autofill

The test mode assistant automatically shows payment method presets for the payment methods included in your integration. You can use these presets to autofill the Payment Element for different payment scenarios.

The test mode assistant autofill tab

Use the payment method presets to autofill Elements.

For example, you can select Magic Fill to autofill all Elements present on the page at the same time.

Integration insights

The test mode assistant highlights integration errors and warnings to help you follow best practices. It also suggests optimization techniques to help manage your integration’s effectiveness, such as using dynamic payment methods if you aren’t already doing so.

The test mode assistant insights tab

View integration errors and warnings

Customer location simulation

The test mode assistant simulates your customer’s location to view what payment methods display to your customers around the world.

The customer location simulation tab in the test mode assistant

Simulate your customer’s location to view your integration in various countries

If you use the Currency Selector Element, you can also simulate the customer’s location to view which payment methods display based on the customer’s chosen currency.

Hide the test mode assistant

By default, Stripe automatically enables the test mode assistant for integrations using Elements with the Checkout Sessions API or for those using Elements with the Payment Intents API on Clover version or later.

To hide the test mode assistant, set the developerTools.assistant.enabled option to false when you set up Elements.

index.js
const stripe = new Stripe(publicKey, { developerTools: { assistant: { enabled: false, }, }, });
Was this page helpful?
YesNo
  • Need help? Contact Support.
  • Join our early access program.
  • Check out our changelog.
  • Questions? Contact Sales.
  • LLM? Read llms.txt.
  • Powered by Markdoc