Stripe Currency Configuration
Select the transaction currency that matches your country’s operations.
Options: You can choose from a wide range of international currencies (e.g., USD for United States, MXN for Mexico, COP for Colombia).
Note: Ensure this matches your Stripe account's primary currency to avoid unexpected conversion fees.
Enable Stripe Testing Mode
Before going live, it is highly recommended to test your checkout flow.
Yes: Use this to perform test transactions using Stripe's test card numbers.
No: Keep this selected for live use. Transactions will be real, and money will be processed.
Testing with Stripe
To simulate successful or failed payments while in Testing Mode, you must use Stripe's official test card numbers.
External Resource: You can find a complete list of test card numbers (for credit cards, digital wallets, and different error scenarios) at the official Stripe Testing Documentation.
Crucial Reminder: Once you are done testing, remember to toggle this setting back to No and ensure your Live Secret and Live Publishable keys are correctly filled in to begin accepting real orders.
Stripe API Keys
To connect your project with Stripe, you must input your API keys found in your Stripe Dashboard.
Key Field | Description |
Stripe Live Publishable Key | Used to identify your account for real transactions. |
Stripe Live Secret Key | A private key used for processing real payments. Never share this key. |
Stripe Test Publishable Key | Used only when Testing Mode is set to "Yes". |
Stripe Test Secret Key | Used only when Testing Mode is set to "Yes". |
How it appears in the Business Settings
The Stripe payment method always appears as an option for each individual store, regardless of whether you have finished the global configuration yet.
To activate it for a specific business:
Go to the Stores section and select a specific business.
Navigate to Payment Methods.
You will see Stripe listed under the Credit card payments section.
Check the box to enable this global account for that specific store.
Important Security Note
When switching from testing to live mode, ensure that you have added both your Live Keys and your Test Keys in their respective fields. Since the platform has dedicated fields for each type, you don't need to overwrite them, but you must verify that:
The Live Keys are correctly entered for real transactions.
The Enable Stripe Testing Mode toggle is set to No when you are ready to receive real payments.