You can test most features of Hercules Commerce inside the Hercules App Editor preview. However, if you want to test the checkout flow, you currently have to publish your app, open it in a separate tab, then test.
No. Hercules Commerce is currently production-only. Our recommendation is to test with your own card and then immediately refund yourself.We are releasing “test mode” with the ability to use a dummy credit card very soon.
Was this page helpful?
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Hercules","colors":{"primary":"#7272F1","light":"#7272F1","dark":"#7272F1"},"logo":{"light":"https://mintcdn.com/zeus-0f6dadbf/j4yNtLOCxtAcoPAC/images/logo.svg?fit=max\u0026auto=format\u0026n=j4yNtLOCxtAcoPAC\u0026q=85\u0026s=7e29d5719cd69890a51afb7e5527111f","dark":"https://mintcdn.com/zeus-0f6dadbf/j4yNtLOCxtAcoPAC/images/logo.svg?fit=max\u0026auto=format\u0026n=j4yNtLOCxtAcoPAC\u0026q=85\u0026s=7e29d5719cd69890a51afb7e5527111f"},"favicon":"https://mintcdn.com/zeus-0f6dadbf/j4yNtLOCxtAcoPAC/images/logo.svg?fit=max\u0026auto=format\u0026n=j4yNtLOCxtAcoPAC\u0026q=85\u0026s=7e29d5719cd69890a51afb7e5527111f","navbar":{"links":[{"href":"mailto:hello@hercules.app","label":"Support"}],"primary":{"type":"button","label":"Start building","href":"https://hercules.app/dashboard"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/37897552","x":"https://x.com/useHercules"}},"seo":{"metatags":{"canonical":"https://hercules.app/docs","robots":"index, follow","description":"Hercules makes it easy to build stunning apps and websites by chatting with AI. The Hercules Docs cover how to build, test, publish, and grow apps with Hercules.","keywords":"Hercules, AI app builder, AI website builder, no-code, low-code, build apps with AI, SaaS, eCommerce, internal tools, mobile apps, documentation, Hercules docs, Hercules documentation","og:description":"Build stunning apps and websites by chatting with AI","og:site_name":"Hercules","og:image":"https://hercules.app/og/home","og:image:width":"1200","og:image:height":"630","og:image:alt":"Hercules - Build stunning apps and websites by chatting with AI","og:locale":"en_US","og:type":"website","twitter:card":"summary_large_image","twitter:description":"Build stunning apps and websites by chatting with AI","twitter:image":"https://hercules.app/og/home","twitter:image:alt":"Hercules - Build stunning apps and websites by chatting with AI","twitter:site":"@usehercules","theme-color":"#7272F1","application-name":"Hercules Docs"},"indexing":"all"},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","codeblocks":{},"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"zeus-0f6dadbf","hasAudioNarration":false,"actualSubdomain":"zeus-0f6dadbf","customDomains":["hercules.app"],"gitSource":{"type":"github","owner":"withzeusai","repo":"hercules.app","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af384e25bd4a55c13c9a540","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"default","tag":"App Builder","count":73},{"language":"default","tag":"Build your app","count":35},{"language":"default","tag":"Agent Builder","count":19},{"language":"default","tag":"Enterprise","count":14},{"language":"default","tag":"Commerce \u0026 Payments","count":11},{"language":"default","tag":"Publish your app","count":10},{"language":"default","tag":"Advanced","count":10},{"language":"default","tag":"App management","count":9},{"language":"default","tag":"Users \u0026 Auth","count":9},{"language":"default","tag":"Platform","count":9}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"hello@hercules.app"}},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#header .mt-2 p{display:none!important}footer a[href*=\"mintlify.com\"]{display:none!important}.screenshot{border-radius:16px;padding:32px;margin:24px auto}.screenshot.compact{max-width:420px;padding:20px}.screenshot img{border-radius:12px;box-shadow:0 25px 50px -12px oklch(0% 0 0 / 0.4);width:100%;display:block;margin:0 auto;color:transparent;background:linear-gradient(110deg, oklch(96% 0 0) 40%, oklch(100% 0 0) 50%, oklch(96% 0 0) 60%);background-size:200% 100%;animation:shimmer 1.5s ease-in-out infinite}@keyframes shimmer{from{background-position:200% 0}to{background-position:-200% 0}}.screenshot.peach{background:linear-gradient(\n 135deg,\n oklch(95.16% 0.0399 75.8) 0%,\n oklch(83.6% 0.088 38.95) 50%,\n oklch(77.72% 0.0988 10.85) 100%\n )}.screenshot.fire{background:linear-gradient(\n 135deg,\n oklch(79.46% 0.1717 323.15) 0%,\n oklch(67.29% 0.1928 16.23) 50%,\n oklch(79.46% 0.1717 323.15) 100%\n )}.screenshot.rain{background:linear-gradient(\n 135deg,\n oklch(91.31% 0.1018 200.91) 0%,\n oklch(72.12% 0.1463 256.92) 50%,\n oklch(91.31% 0.1018 200.91) 100%\n )}.screenshot.rainbow{background:linear-gradient(\n 135deg,\n oklch(89.96% 0.0688 192.59) 0%,\n oklch(91.35% 0.0475 356.55) 25%,\n oklch(75% 0.0867 337.05) 50%,\n oklch(97.73% 0.0445 100.28) 75%,\n oklch(89.96% 0.0688 192.59) 100%\n )}.screenshot.floss{background:linear-gradient(\n 135deg,\n oklch(87.7% 0.0835 336.72) 0%,\n oklch(80.65% 0.0705 260.56) 50%,\n oklch(87.7% 0.0835 336.72) 100%\n )}.screenshot.purple{background:linear-gradient(\n 135deg,\n oklch(62.71% 0.1638 271.53) 0%,\n oklch(50.12% 0.1384 304.73) 50%,\n oklch(62.71% 0.1638 271.53) 100%\n )}.screenshot.ocean{background:linear-gradient(\n 135deg,\n oklch(61.6% 0.1041 219.93) 0%,\n oklch(81.96% 0.1019 214.8) 50%,\n oklch(61.6% 0.1041 219.93) 100%\n )}.screenshot.sunset{background:linear-gradient(135deg, oklch(72.19% 0.1727 3.33) 0%, oklch(90.77% 0.1703 98.5) 100%)}.screenshot.mint{background:linear-gradient(\n 135deg,\n oklch(67.85% 0.1229 180.24) 0%,\n oklch(77.36% 0.1743 127.5) 100%\n )}.screenshot.cosmic{background:linear-gradient(\n 135deg,\n oklch(62.71% 0.1638 271.53) 0%,\n oklch(50.12% 0.1384 304.73) 50%,\n oklch(79.46% 0.1717 323.15) 100%\n )}.screenshot.aurora{background:linear-gradient(\n 135deg,\n oklch(76.58% 0.1351 167.79) 0%,\n oklch(46.42% 0.1261 252.86) 100%\n )}.screenshot.honey{background:linear-gradient(\n 135deg,\n oklch(75.93% 0.164 64.36) 0%,\n oklch(87.69% 0.1796 93.13) 100%\n )}.screenshot.lavender{background:linear-gradient(\n 135deg,\n oklch(69.36% 0.1994 311.3) 0%,\n oklch(74.04% 0.1955 341.99) 100%\n )}.screenshot.emerald{background:linear-gradient(\n 135deg,\n oklch(61.58% 0.1054 185.75) 0%,\n oklch(83.89% 0.2113 150.66) 100%\n )}.screenshot.coral{background:linear-gradient(\n 135deg,\n oklch(71.16% 0.1812 22.84) 0%,\n oklch(86.43% 0.1427 84.36) 100%\n )}.screenshot.midnight{background:linear-gradient(\n 135deg,\n oklch(17.85% 0.0571 283.68) 0%,\n oklch(32.7% 0.0956 283.81) 50%,\n oklch(27.37% 0.0477 282.79) 100%\n )}.screenshot.rose{background:linear-gradient(\n 135deg,\n oklch(95.16% 0.0399 75.8) 0%,\n oklch(83.6% 0.088 38.95) 50%,\n oklch(79.12% 0.1211 17.63) 100%\n )}.screenshot.slate{background:linear-gradient(135deg, oklch(38.29% 0 0) 0%, oklch(0% 0 0) 100%)}.screenshot.berry{background:linear-gradient(\n 135deg,\n oklch(54.01% 0.2493 302.67) 0%,\n oklch(44.37% 0.2683 280.08) 100%\n )}.screenshot.aqua{background:linear-gradient(\n 135deg,\n oklch(79.96% 0.1463 220.71) 0%,\n oklch(58.62% 0.1533 257.23) 100%\n )}.screenshot.candy{background:linear-gradient(\n 135deg,\n oklch(71.66% 0.1824 10.57) 0%,\n oklch(79.32% 0.1234 8.25) 50%,\n oklch(83.6% 0.088 38.95) 100%\n )}.screenshot.forest{background:linear-gradient(\n 135deg,\n oklch(39.48% 0.0637 220.22) 0%,\n oklch(70.62% 0.099 150.56) 100%\n )}.dark .screenshot img{box-shadow:0 25px 50px -12px oklch(0% 0 0 / 0.6)}.highlight{font-weight:600;padding:2px 8px;border-radius:4px}.highlight-purple{color:oklch(60.56% 0.2189 292.72);background-color:oklch(94.33% 0.0284 294.59)}.highlight-green{color:oklch(69.59% 0.1491 162.48);background-color:oklch(95.05% 0.0507 163.05)}.highlight-blue{color:oklch(62.31% 0.188 259.81);background-color:oklch(93.19% 0.0316 255.59)}.highlight-pink{color:oklch(72.53% 0.1752 349.76);background-color:oklch(94.82% 0.0276 342.26)}.highlight-amber{color:oklch(76.86% 0.1647 70.08);background-color:oklch(96.19% 0.058 95.62)}.highlight-indigo{color:oklch(58.54% 0.2041 277.12);background-color:oklch(92.99% 0.0334 272.79)}.highlight-orange{color:oklch(64.61% 0.1943 41.12);background-color:oklch(95.42% 0.0372 75.16)}.dark .highlight-purple{color:oklch(80.56% 0.1689 292.72);background-color:oklch(28% 0.0684 294.59)}.dark .highlight-green{color:oklch(82.59% 0.1291 162.48);background-color:oklch(28% 0.0507 163.05)}.dark .highlight-blue{color:oklch(79.31% 0.148 259.81);background-color:oklch(28% 0.0516 255.59)}.dark .highlight-pink{color:oklch(82.53% 0.1352 349.76);background-color:oklch(28% 0.0476 342.26)}.dark .highlight-amber{color:oklch(85.86% 0.1447 70.08);background-color:oklch(28% 0.048 95.62)}.dark .highlight-indigo{color:oklch(78.54% 0.1641 277.12);background-color:oklch(28% 0.0634 272.79)}.dark .highlight-orange{color:oklch(80.61% 0.1543 41.12);background-color:oklch(28% 0.0472 75.16)}.icon-card-grid{display:grid;grid-template-columns:repeat(4, 1fr);gap:12px}@media (max-width: 768px){.icon-card-grid{grid-template-columns:repeat(3, 1fr)}}.icon-card{display:flex;flex-direction:column;align-items:center;padding:20px 16px;background-color:oklch(100% 0 0);border-radius:12px;text-decoration:none;height:120px;border:1px solid oklch(92.76% 0.0058 264.53);transition:transform 0.15s ease,\n box-shadow 0.15s ease,\n border-color 0.15s ease}.icon-card:hover{transform:translateY(-2px);box-shadow:0 4px 12px oklch(0% 0 0 / 0.1);border-color:oklch(62.31% 0.188 259.81)}.dark .icon-card{background-color:oklch(22% 0 0);border-color:oklch(32% 0.0058 264.53)}.dark .icon-card:hover{box-shadow:0 4px 12px oklch(0% 0 0 / 0.4);border-color:oklch(62.31% 0.148 259.81)}.dark .icon-card-label{color:oklch(90% 0 0)}.icon-card-icon{height:36px;display:flex;align-items:center;justify-content:center;flex-shrink:0}.icon-card-label{margin-top:12px;font-size:14px;font-weight:500;color:oklch(17.76% 0 0);text-align:center}.dark .icon-color-blue svg{color:#60a5fa!important}.dark .icon-color-violet svg{color:#a78bfa!important}.dark .icon-color-emerald svg{color:#34d399!important}.dark .icon-color-amber svg{color:#fbbf24!important}.dark .icon-color-cyan svg{color:#22d3ee!important}.dark .icon-color-pink svg{color:#f9a8d4!important}.dark .icon-color-indigo svg{color:#818cf8!important}.dark .icon-color-teal svg{color:#2dd4bf!important}.dark .icon-color-rose svg{color:#fb7185!important}.dark .icon-color-red svg{color:#f87171!important}.dark .icon-color-lime svg{color:#a3e635!important}.dark .icon-color-purple svg{color:#c084fc!important}a.not-bold{font-weight:normal}.mdx-content ul,.mdx-content ol{margin-top:0.5rem!important;margin-bottom:2rem!important}.mdx-content li{margin:0.25rem 0!important}.mdx-content li>ul,.mdx-content li>ol{margin-top:0.25rem!important;margin-bottom:0.25rem!important}.mdx-content *:has(+ul),.mdx-content *:has(+ol){margin-bottom:0.25rem!important}.mdx-content table td,.mdx-content table th{text-align:left!important;vertical-align:middle!important}table td button{text-align:left!important;cursor:help}.image-carousel{display:flex;gap:12px;overflow-x:auto;scroll-snap-type:x mandatory;-webkit-overflow-scrolling:touch;padding-bottom:12px}.image-carousel::-webkit-scrollbar{height:8px}.image-carousel::-webkit-scrollbar-track{background:oklch(95.81% 0 0);border-radius:4px}.image-carousel::-webkit-scrollbar-thumb{background:oklch(81.09% 0 0);border-radius:4px}.image-carousel::-webkit-scrollbar-thumb:hover{background:oklch(70.9% 0 0)}.dark .image-carousel::-webkit-scrollbar-track{background:oklch(28.5% 0 0)}.dark .image-carousel::-webkit-scrollbar-thumb{background:oklch(40.91% 0 0)}.dark .image-carousel::-webkit-scrollbar-thumb:hover{background:oklch(46.76% 0 0)}.image-carousel img{flex-shrink:0;scroll-snap-align:start;border-radius:12px;height:280px;width:auto;object-fit:contain;box-shadow:0 4px 12px oklch(0% 0 0 / 0.1)}.dark .image-carousel img{box-shadow:0 4px 12px oklch(0% 0 0 / 0.3)}.image-showcase{margin:0 0 16px 0}.image-showcase-title{font-size:14px;font-weight:600;color:oklch(55.1% 0.0234 264.36);text-transform:uppercase;letter-spacing:0.05em;margin-bottom:12px}.dark .image-showcase-title{color:oklch(71.37% 0.0192 261.32)}"},{"filePath":"css/sms-rate-lookup.css","content":"#sms-rate-lookup{margin:1rem 0 1.5rem}#sms-rate-lookup label{display:block;margin-bottom:0.375rem;font-weight:600}#sms-rate-lookup input{width:100%;padding:0.5rem 0.75rem;border:1px solid color-mix(in srgb, currentColor 30%, transparent);border-radius:0.5rem;background:transparent;color:inherit;font:inherit}#sms-rate-lookup .sms-rate-result{margin:0.75rem 0 0;font-weight:600}#sms-rate-lookup .sms-rate-updated{margin:0.25rem 0 0;font-size:0.875rem;opacity:0.7}"}],"page":{"pagePath":"apps/commerce/testing","slug":"/apps/commerce/testing","pageMetadata":{"title":"Testing Hercules Commerce","sidebarTitle":"Testing","description":"Test Hercules Commerce in preview or on a published app. Production-only; test with real card then refund.","keywords":["commerce testing","test payments","checkout testing"],"href":"/apps/commerce/testing"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Test Hercules Commerce in preview or on a published app. Production-only; test with real card then refund.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={p:`p`,..._provideComponents(),...props.components},{Heading}=_components;if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`3`,id:`how-do-i-test-hercules-commerce`,children:`How do I test Hercules Commerce?`}),`\n`,_jsx(_components.p,{children:`You can test most features of Hercules Commerce inside the Hercules App Editor preview. However, if you want to test the checkout flow, you currently have to publish your app, open it in a separate tab, then test.`}),`\n`,_jsx(Heading,{level:`3`,id:`can-i-test-payments-without-using-my-real-card`,children:`Can I test payments without using my real card?`}),`\n`,_jsx(_components.p,{children:`No. Hercules Commerce is currently production-only. Our recommendation is to test with your own card and then immediately refund yourself.`}),`\n`,_jsx(_components.p,{children:`We are releasing “test mode” with the ability to use a dummy credit card very soon.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{},"config":{},"pageMetadata":{"title":"Testing Hercules Commerce","sidebarTitle":"Testing","description":"Test Hercules Commerce in preview or on a published app. Production-only; test with real card then refund.","keywords":["commerce testing","test payments","checkout testing"],"href":"/apps/commerce/testing"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"How do I test Hercules Commerce?","slug":"how-do-i-test-hercules-commerce","depth":3,"children":[]},{"title":"Can I test payments without using my real card?","slug":"can-i-test-payments-without-using-my-real-card","depth":3,"children":[]}],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/zeus-0f6dadbf/d7f02ff6a6be6eb2/js/sms-rate-lookup.js","/docs/_mintlify/custom/zeus-0f6dadbf/a3858fb258311993/js/sms-rates.js"],"subdomain":"zeus-0f6dadbf","siteName":"Hercules","title":"Testing Hercules Commerce - Hercules","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-12T23:15:46.709Z","originalFileLocation":"apps/commerce/testing.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Test Hercules Commerce in preview or on a published app. Production-only; test with real card then refund.\">\u003cmeta data-mint-head name=\"keywords\" content=\"Hercules, AI app builder, AI website builder, no-code, low-code, build apps with AI, SaaS, eCommerce, internal tools, mobile apps, documentation, Hercules docs, Hercules documentation\">\u003cmeta data-mint-head name=\"application-name\" content=\"Hercules\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/zeus-0f6dadbf/13481PjGo8Hi99OM/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/zeus-0f6dadbf/13481PjGo8Hi99OM/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/zeus-0f6dadbf/13481PjGo8Hi99OM/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/zeus-0f6dadbf/13481PjGo8Hi99OM/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/zeus-0f6dadbf/13481PjGo8Hi99OM/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/zeus-0f6dadbf/13481PjGo8Hi99OM/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/zeus-0f6dadbf/13481PjGo8Hi99OM/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/zeus-0f6dadbf/13481PjGo8Hi99OM/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/zeus-0f6dadbf/13481PjGo8Hi99OM/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Testing Hercules Commerce - Hercules\">\u003cmeta data-mint-head property=\"og:description\" content=\"Build stunning apps and websites by chatting with AI\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Hercules\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://hercules.app/docs/apps/commerce/testing\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://hercules.app/og/home\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Testing Hercules Commerce - Hercules\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Build stunning apps and websites by chatting with AI\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://hercules.app/og/home\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/zeus-0f6dadbf/13481PjGo8Hi99OM/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Hercules\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7272F1\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003cmeta data-mint-head name=\"og:image:alt\" content=\"Hercules - Build stunning apps and websites by chatting with AI\">\u003cmeta data-mint-head name=\"twitter:image:alt\" content=\"Hercules - Build stunning apps and websites by chatting with AI\">\u003cmeta data-mint-head name=\"theme-color\" content=\"#7272F1\">\u003cmeta data-mint-head name=\"application-name\" content=\"Hercules Docs\">\u003clink data-mint-head rel=\"canonical\" href=\"https://hercules.app/docs/apps/commerce/testing\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/apps/commerce/testing.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://hercules.app/#organization\",\"name\":\"Hercules\",\"url\":\"https://hercules.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/zeus-0f6dadbf/j4yNtLOCxtAcoPAC/images/logo.svg?fit=max\u0026auto=format\u0026n=j4yNtLOCxtAcoPAC\u0026q=85\u0026s=7e29d5719cd69890a51afb7e5527111f\"}},{\"@type\":\"WebSite\",\"@id\":\"https://hercules.app/docs#website\",\"name\":\"Hercules\",\"url\":\"https://hercules.app/docs\",\"publisher\":{\"@id\":\"https://hercules.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://hercules.app/docs/apps/commerce/testing#webpage\",\"url\":\"https://hercules.app/docs/apps/commerce/testing\",\"name\":\"Testing Hercules Commerce\",\"description\":\"Test Hercules Commerce in preview or on a published app. Production-only; test with real card then refund.\",\"dateModified\":\"2026-03-12T23:15:46.709Z\",\"isPartOf\":{\"@id\":\"https://hercules.app/docs#website\"},\"breadcrumb\":{\"@id\":\"https://hercules.app/docs/apps/commerce/testing#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://hercules.app/docs/apps/commerce/testing#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Build your app\",\"item\":\"https://hercules.app/docs/apps/branding-seo\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Commerce \u0026 Payments\",\"item\":\"https://hercules.app/docs/apps/commerce/get-started\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Testing Hercules Commerce\",\"item\":\"https://hercules.app/docs/apps/commerce/testing\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://hercules.app/docs/apps/commerce/testing#article\",\"headline\":\"Testing Hercules Commerce\",\"name\":\"Testing Hercules Commerce\",\"description\":\"Test Hercules Commerce in preview or on a published app. Production-only; test with real card then refund.\",\"url\":\"https://hercules.app/docs/apps/commerce/testing\",\"mainEntityOfPage\":{\"@id\":\"https://hercules.app/docs/apps/commerce/testing#webpage\"},\"image\":\"https://hercules.app/og/home\",\"dateModified\":\"2026-03-12T23:15:46.709Z\",\"keywords\":\"commerce testing, test payments, checkout testing\",\"publisher\":{\"@id\":\"https://hercules.app/#organization\"},\"isPartOf\":{\"@id\":\"https://hercules.app/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Hercules\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Hercules\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/apps/commerce/testing.md","siteName":"Hercules","nav":{"global":null,"tabs":[{"tab":"App Builder","groups":[{"group":"Get Started","pages":[{"title":"Welcome to Hercules","sidebarTitle":"Welcome","href":"/welcome"},{"title":"Quickstart","sidebarTitle":"Quickstart: Build an app in 1 min","href":"/apps/quickstart"}]},{"group":"Hercules App Builder Agent","pages":[{"title":"How the Hercules App Builder Agent Works","sidebarTitle":"How the Agent works","href":"/ai/how-it-works"},{"title":"Agent Modes","sidebarTitle":"Agent modes","href":"/ai/agent-modes"},{"title":"Multi-Agent","sidebarTitle":"Multi-agent","href":"/ai/multi-agent"},{"title":"Skills","sidebarTitle":"Skills","href":"/ai/skills"},{"title":"Chat Integrations (aka MCP Servers)","sidebarTitle":"Chat Integrations","href":"/ai/chat-connectors"},{"title":"Hercules MCP","sidebarTitle":"Hercules MCP","href":"/hercules-mcp"},{"title":"Make Hercules more accurate","sidebarTitle":"Improve Accuracy","tag":"Recommended","href":"/ai/improve-accuracy"}]},{"group":"Build your app","pages":[{"title":"Branding \u0026 SEO","sidebarTitle":"Branding \u0026 SEO","href":"/apps/branding-seo"},{"title":"Roadmap","sidebarTitle":"Roadmap","href":"/apps/roadmap"},{"group":"Users \u0026 Auth","pages":[{"title":"Hercules Auth","sidebarTitle":"Get Started","href":"/apps/users-auth/get-started"},{"title":"Customize Auth Portal","sidebarTitle":"Customize Auth Portal","href":"/apps/users-auth/customize-auth-portal"},{"title":"Connect your own SMS provider","sidebarTitle":"Custom SMS Provider","href":"/apps/users-auth/sms-provider-custom"},{"title":"Sign-in Rules","sidebarTitle":"Sign-in Rules","href":"/apps/users-auth/sign-in-rules"},{"title":"Single Sign-On (SSO)","sidebarTitle":"Single Sign-On","href":"/apps/users-auth/single-sign-on"},{"title":"Audit Log","sidebarTitle":"Audit Log","href":"/apps/users-auth/audit-log"},{"title":"Users, Roles \u0026 Permissions","sidebarTitle":"Users, Roles \u0026 Permissions","href":"/apps/users-auth/users-roles-permissions"},{"title":"Debug Common Auth Issues","sidebarTitle":"Debug Common Auth Issues","href":"/apps/users-auth/debug-auth"},{"title":"Upgrade to Hercules Auth 2.0","sidebarTitle":"Upgrade Auth","href":"/apps/users-auth/upgrade-to-hercules-auth-2"}]},{"group":"Commerce \u0026 Payments","pages":[{"title":"Hercules Commerce","sidebarTitle":"Get Started","href":"/apps/commerce/get-started"},{"title":"Products \u0026 Features","sidebarTitle":"Products \u0026 Features","href":"/apps/commerce/products-features"},{"title":"Integrate Into My App","sidebarTitle":"Integrate Into My App","href":"/apps/commerce/integrate-into-my-app"},{"title":"Customers","sidebarTitle":"Customers","href":"/apps/commerce/customers"},{"title":"Transactions","sidebarTitle":"Transactions","href":"/apps/commerce/transactions"},{"title":"Payouts","sidebarTitle":"Payouts","href":"/apps/commerce/payouts"},{"title":"Coupons","sidebarTitle":"Coupons","description":"Create discount codes for promotions. Set percentage or fixed discounts with usage limits and expiration.","href":"/apps/commerce/coupons"},{"title":"Testing Hercules Commerce","sidebarTitle":"Testing","href":"/apps/commerce/testing"},{"title":"Compliance","sidebarTitle":"Compliance","description":"Verify identity and business before accepting payments. KYC, bank account, and Stripe verification.","href":"/apps/commerce/compliance"},{"title":"Other Settings","sidebarTitle":"Other Settings","href":"/apps/commerce/other-settings"},{"title":"Hercules Commerce Support","sidebarTitle":"Support","href":"/apps/commerce/support"}]},{"group":"Mobile","pages":[{"title":"Mobile Apps","sidebarTitle":"Get Started","href":"/apps/mobile/get-started"},{"title":"Test Your Mobile App","sidebarTitle":"Test Mobile App","href":"/apps/mobile/test-mobile"}]},{"title":"Hercules Email","sidebarTitle":"Email","href":"/apps/emails"},{"title":"Hercules Files \u0026 Media","sidebarTitle":"Files \u0026 Media","href":"/apps/files-media-storage"},{"title":"Visual Edit","sidebarTitle":"Visual edit","href":"/apps/visual-edit"},{"title":"Hercules AI Image Generation","sidebarTitle":"AI Image generation","href":"/apps/image-generation"},{"group":"AI Gateway","pages":[{"title":"Hercules AI Gateway","sidebarTitle":"Get Started","href":"/apps/ai-gateway"},{"title":"AI Decisions with Jev","sidebarTitle":"AI Decisions","href":"/apps/ai-gateway/decisions"}]},{"title":"Push Notifications","sidebarTitle":"Push Notifications","href":"/apps/push-notifications"},{"title":"Internationalization","sidebarTitle":"Internationalization","href":"/apps/internationalization"},{"title":"Audits","sidebarTitle":"Audits","href":"/apps/audits"},{"title":"Browser Tests","sidebarTitle":"Browser tests","href":"/apps/browser-tests"},{"title":"Capture Tools","sidebarTitle":"Capture tools","href":"/apps/capture-tools"}]},{"group":"Publish your app","pages":[{"group":"Publish to a domain","pages":[{"title":"Buy a domain in Hercules","sidebarTitle":"Buy a domain in Hercules","href":"/apps/publish/buy-domain"},{"title":"Connect an existing domain","sidebarTitle":"Connect an existing domain","href":"/apps/publish/connect-existing-domain"},{"title":"Publish to a free Hercules subdomain","sidebarTitle":"Free Hercules subdomain","href":"/apps/publish/hercules-domain"},{"title":"How to publish your app","sidebarTitle":"How to publish","href":"/apps/publish/how-to-publish"},{"title":"Google Safe Browsing warnings on your domain","sidebarTitle":"Google Safe Browsing warnings","href":"/apps/publish/domain-warnings"}]},{"group":"Publish to App Store","pages":[{"title":"Publish Your App","sidebarTitle":"Publish to App Store","href":"/apps/mobile/publish-app-store"},{"title":"Google Play and App Store Requirements","sidebarTitle":"Store Requirements","href":"/apps/mobile/store-requirements"},{"title":"Update Your App","sidebarTitle":"Update in App Store","href":"/apps/mobile/update-mobile-app"}]},{"title":"Publish your app to Hercules Showcase","sidebarTitle":"Publish to Hercules Showcase","hidden":true,"href":"/apps/publish/hercules-showcase"},{"title":"Analytics","sidebarTitle":"Analytics","href":"/apps/analytics"}]},{"group":"Advanced","pages":[{"title":"Version Control","sidebarTitle":"Version Control","href":"/apps/version-control"},{"title":"Branches","sidebarTitle":"Branches","href":"/apps/branches"},{"title":"Environments","sidebarTitle":"Environments","href":"/apps/environments"},{"title":"Database","sidebarTitle":"Database","href":"/apps/database"},{"title":"Backend","sidebarTitle":"Backend","href":"/apps/backend"},{"title":"Dev Machines","sidebarTitle":"Dev Machines","href":"/apps/dev-machines"},{"title":"Code Editor","sidebarTitle":"Code Editor","href":"/apps/code-editor"},{"title":"Secrets","sidebarTitle":"Secrets","href":"/apps/secrets"},{"title":"Security Audit","sidebarTitle":"Security Audit","href":"/apps/security"},{"title":"Security Headers","sidebarTitle":"Security Headers","href":"/apps/security-headers"}]},{"group":"App management","pages":[{"title":"Manage apps","sidebarTitle":"Manage apps","href":"/apps/app-management"},{"title":"Transfer an app to another organization","sidebarTitle":"Transfer an app","href":"/apps/app-transfer"},{"group":"Migrate to Hercules","root":{"title":"Migrate to Hercules","sidebarTitle":"Migrate to Hercules","href":"/apps/migrate/overview"},"pages":[{"title":"Migrate from Lovable to Hercules","sidebarTitle":"Migrate from Lovable","href":"/apps/migrate/lovable"},{"title":"Migrate from Replit to Hercules","sidebarTitle":"Migrate from Replit","href":"/apps/migrate/replit"},{"title":"Migrate from Base44 to Hercules","sidebarTitle":"Migrate from Base44","href":"/apps/migrate/base44"},{"title":"Migrate from Emergent to Hercules","sidebarTitle":"Migrate from Emergent","href":"/apps/migrate/emergent"},{"title":"Migrate from Claude Code to Hercules","sidebarTitle":"Migrate from Claude Code","href":"/apps/migrate/claude-code"},{"title":"Migrate from Codex to Hercules","sidebarTitle":"Migrate from Codex","href":"/apps/migrate/codex"}]},{"title":"Export Data","sidebarTitle":"Export Data","href":"/apps/export-data"}]}]},{"tab":"Agent Builder","pages":[{"title":"Agent Builder","href":"/agents/what-are-agents"}]},{"tab":"Platform","pages":[{"title":"Platform","href":"/platform/teammates"}]},{"tab":"Enterprise","pages":[{"title":"Enterprise","href":"/enterprise/overview"}]}]},"basePath":"","title":"Testing Hercules Commerce - Hercules","buildId":"dpl_2AK98Hxhwu4fUXpx9atbv41cC328","deploymentId":"dpl_2AK98Hxhwu4fUXpx9atbv41cC328","dynamics":[],"chunks":[]}