Learn about the upcoming Sandbox environment for safe testing and integration.
The Sandbox is not yet available, we’re working on it. If you’d like to join the beta, get in touch with us at hello@bitgpt.xyz
The Sandbox is a fully isolated testing environment that allows organizations to experiment with the API, integrations, and workflows without affecting live data or production systems.
The API base URL for the Sandbox will stay the same, in order to send requests to the sandbox environment you’ll have to pass the X-Test-Mode header as true
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"BitGPT 402pay Documentation","colors":{"primary":"#2E74FF","light":"#F5F2E9","dark":"#1E54BF"},"logo":{"light":"https://mintcdn.com/bitgpt/N6Qn8nkrAkxXvrVZ/images/logo/light.png?fit=max\u0026auto=format\u0026n=N6Qn8nkrAkxXvrVZ\u0026q=85\u0026s=983649556b8a67d1d2025eaca748d434","dark":"https://mintcdn.com/bitgpt/N6Qn8nkrAkxXvrVZ/images/logo/dark.png?fit=max\u0026auto=format\u0026n=N6Qn8nkrAkxXvrVZ\u0026q=85\u0026s=1fb970415ae19b9b2a779415fa394d42"},"favicon":"/images/favicon.png","navbar":{"links":[{"label":"Demo","href":"https://play.bitgpt.xyz"},{"label":"Support","href":"mailto:support@bitgpt.xyz"}],"primary":{"type":"button","label":"Dashboard","href":"https://dash.bitgpt.xyz"}},"footer":{"socials":{"x":"https://x.com/BitGPTnetwork","discord":"https://bitgpt.xyz/discord"}},"seo":{"metatags":{"og:image":"/images/og.png","og:title":"BitGPT 402pay Documentation","og:description":"One platform to leverage blockchain-native payments for the future of commerce, agents and payments.","twitter:title":"BitGPT 402pay Documentation","twitter:description":"One platform to leverage blockchain-native payments for the future of commerce, agents and payments.","twitter:image":"/images/og.png"}},"styling":{"codeblocks":"system"},"contextual":{"options":["chatgpt","claude","copy","view"]},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"bitgpt","hasAudioNarration":false,"actualSubdomain":"bitgpt","customDomains":["docs.bitgpt.xyz"],"gitSource":{"type":"github","owner":"bit-gpt","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21e6c694a5dc2e6daf4379","collectionId":"c41e2263-12b1-4185-9c84-da13bd9e6d07","schemaVersion":"v2"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6a21e6c694a5dc2e6daf4379:success","clientVersion":"0.0.4045","searchFilterCounts":[{"language":"default","tag":"Developer resources","count":71},{"language":"default","tag":"API REFERENCE","count":45},{"language":"default","tag":"WEBHOOKS","count":16},{"language":"default","tag":"Payloads","count":14},{"language":"default","tag":"Payments and Invoices","count":12},{"language":"default","tag":"Webhooks","count":12},{"language":"default","tag":"Get started","count":11},{"language":"default","tag":"GET STARTED","count":10},{"language":"default","tag":"API Keys","count":10},{"language":"default","tag":"Schemas","count":8}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"developer-resources/get-started/sandbox","slug":"/developer-resources/get-started/sandbox","pageMetadata":{"title":"Sandbox","sidebarTitle":"Sandbox","description":"Learn about the upcoming Sandbox environment for safe testing and integration.","icon":"flask-vial","href":"/developer-resources/get-started/sandbox"},"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: \"Learn about the upcoming Sandbox environment for safe testing and integration.\"\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={blockquote:`blockquote`,code:`code`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Frame,Heading,OptimizedImage,Warning}=_components;if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(Warning,{children:[`The Sandbox is not yet available, we’re working on it. If you’d like to join the beta, get in touch with us at `,_jsx(_components.code,{children:`hello@bitgpt.xyz`})]}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`Sandbox`}),` is a fully isolated testing environment that allows organizations to experiment with the API, integrations, and workflows without affecting live data or production systems.`]}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/bitgpt/N6Qn8nkrAkxXvrVZ/images/pages/developer-resources/test-mode.png?fit=max\u0026auto=format\u0026n=N6Qn8nkrAkxXvrVZ\u0026q=85\u0026s=8e1f32036185f0f2166e2e90d52dcbff`,alt:`Test mode dashboard`,\"data-og-width\":`4368`,width:`4368`,\"data-og-height\":`3108`,height:`3108`,\"data-path\":`images/pages/developer-resources/test-mode.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/bitgpt/N6Qn8nkrAkxXvrVZ/images/pages/developer-resources/test-mode.png?w=280\u0026fit=max\u0026auto=format\u0026n=N6Qn8nkrAkxXvrVZ\u0026q=85\u0026s=f284315f73296211dc46c7d883e39888 280w, https://mintcdn.com/bitgpt/N6Qn8nkrAkxXvrVZ/images/pages/developer-resources/test-mode.png?w=560\u0026fit=max\u0026auto=format\u0026n=N6Qn8nkrAkxXvrVZ\u0026q=85\u0026s=1f55cd9af55db3ece760c340e7dbbd48 560w, https://mintcdn.com/bitgpt/N6Qn8nkrAkxXvrVZ/images/pages/developer-resources/test-mode.png?w=840\u0026fit=max\u0026auto=format\u0026n=N6Qn8nkrAkxXvrVZ\u0026q=85\u0026s=fe1ecea082a43250098d467f55db440f 840w, https://mintcdn.com/bitgpt/N6Qn8nkrAkxXvrVZ/images/pages/developer-resources/test-mode.png?w=1100\u0026fit=max\u0026auto=format\u0026n=N6Qn8nkrAkxXvrVZ\u0026q=85\u0026s=300e0c3d73c7d4d4289fee58acf8fb19 1100w, https://mintcdn.com/bitgpt/N6Qn8nkrAkxXvrVZ/images/pages/developer-resources/test-mode.png?w=1650\u0026fit=max\u0026auto=format\u0026n=N6Qn8nkrAkxXvrVZ\u0026q=85\u0026s=b6970e78b52a798053ab28de0928c8cc 1650w, https://mintcdn.com/bitgpt/N6Qn8nkrAkxXvrVZ/images/pages/developer-resources/test-mode.png?w=2500\u0026fit=max\u0026auto=format\u0026n=N6Qn8nkrAkxXvrVZ\u0026q=85\u0026s=a6d742e399d15b727444b2559fa94a69 2500w`})}),`\n`,_jsx(Heading,{level:`2`,id:`current-status`,children:`Current Status`}),`\n`,_jsxs(_components.p,{children:[`We’re actively working on it, and once released, it will be a `,_jsx(_components.strong,{children:`1:1 clone`}),` of the production environment.`]}),`\n`,_jsx(_components.p,{children:`This means:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Identical API behavior and structure`}),`\n`,_jsx(_components.li,{children:`Fully separate infrastructure`}),`\n`,_jsx(_components.li,{children:`Safe to test everything, from authentication to payment creation`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`how-it-will-work`,children:`How It Will Work`}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/bitgpt/N6Qn8nkrAkxXvrVZ/images/pages/developer-resources/test-mode-toggle.png?fit=max\u0026auto=format\u0026n=N6Qn8nkrAkxXvrVZ\u0026q=85\u0026s=ca9ff38b9916151f91196ef5e71c50c7`,alt:`Test mode toggle`,height:`100`,\"data-og-width\":`1218`,\"data-og-height\":`1245`,\"data-path\":`images/pages/developer-resources/test-mode-toggle.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/bitgpt/N6Qn8nkrAkxXvrVZ/images/pages/developer-resources/test-mode-toggle.png?w=280\u0026fit=max\u0026auto=format\u0026n=N6Qn8nkrAkxXvrVZ\u0026q=85\u0026s=125ed1f96834a12b3993ea51cb407bbd 280w, https://mintcdn.com/bitgpt/N6Qn8nkrAkxXvrVZ/images/pages/developer-resources/test-mode-toggle.png?w=560\u0026fit=max\u0026auto=format\u0026n=N6Qn8nkrAkxXvrVZ\u0026q=85\u0026s=bddec3d8ed8ff1a4ebf15b940dd14b3f 560w, https://mintcdn.com/bitgpt/N6Qn8nkrAkxXvrVZ/images/pages/developer-resources/test-mode-toggle.png?w=840\u0026fit=max\u0026auto=format\u0026n=N6Qn8nkrAkxXvrVZ\u0026q=85\u0026s=93886af581065335065e68ca658b3885 840w, https://mintcdn.com/bitgpt/N6Qn8nkrAkxXvrVZ/images/pages/developer-resources/test-mode-toggle.png?w=1100\u0026fit=max\u0026auto=format\u0026n=N6Qn8nkrAkxXvrVZ\u0026q=85\u0026s=2b455efc32d9c0c386790c24148089b8 1100w, https://mintcdn.com/bitgpt/N6Qn8nkrAkxXvrVZ/images/pages/developer-resources/test-mode-toggle.png?w=1650\u0026fit=max\u0026auto=format\u0026n=N6Qn8nkrAkxXvrVZ\u0026q=85\u0026s=183cee40e2411bcc8541c3c08114ba12 1650w, https://mintcdn.com/bitgpt/N6Qn8nkrAkxXvrVZ/images/pages/developer-resources/test-mode-toggle.png?w=2500\u0026fit=max\u0026auto=format\u0026n=N6Qn8nkrAkxXvrVZ\u0026q=85\u0026s=2e345790d45d39ea8dfe91d4b91ae1fd 2500w`}),`\n`,_jsxs(_components.p,{children:[`When released, you’ll be able to `,_jsx(_components.strong,{children:`access the Sandbox directly from your dashboard`}),`:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`A toggle will appear in the top right section (your profile) under `,_jsx(_components.code,{children:`Test Mode`})]}),`\n`,_jsxs(_components.li,{children:[`Switching it `,_jsx(_components.strong,{children:`enables Sandbox mode`})]}),`\n`,_jsxs(_components.li,{children:[`The interface will `,_jsx(_components.strong,{children:`turn orange`}),` to indicate you are working in the test environment`]}),`\n`]}),`\n`,_jsxs(_components.blockquote,{children:[`\n`,_jsx(_components.p,{children:`All actions and data in the Sandbox are isolated from your production account.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`what-you’ll-be-able-to-test`,children:`What You’ll Be Able to Test`}),`\n`,_jsx(_components.p,{children:`Once available, the Sandbox will support:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Creating and managing test API keys`}),`\n`,_jsx(_components.li,{children:`Simulating cryptocurrency and fiat transactions`}),`\n`,_jsx(_components.li,{children:`Testing webhooks and real-time callbacks`}),`\n`,_jsx(_components.li,{children:`Managing products, licensing, billing flows, and more`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Certain features, such as the non-custodial wallet, will not be available. In those cases, you’ll see a notice similar to this`}),`:`]}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/bitgpt/N6Qn8nkrAkxXvrVZ/images/pages/developer-resources/feature-not-available.png?fit=max\u0026auto=format\u0026n=N6Qn8nkrAkxXvrVZ\u0026q=85\u0026s=2b1f9bc23645694b6d5a2bc02ab847a2`,alt:`Test mode feature not available`,height:`100`,\"data-og-width\":`1344`,\"data-og-height\":`2112`,\"data-path\":`images/pages/developer-resources/feature-not-available.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/bitgpt/N6Qn8nkrAkxXvrVZ/images/pages/developer-resources/feature-not-available.png?w=280\u0026fit=max\u0026auto=format\u0026n=N6Qn8nkrAkxXvrVZ\u0026q=85\u0026s=c3fe9a9eeb4a19660e5aba4c596019db 280w, https://mintcdn.com/bitgpt/N6Qn8nkrAkxXvrVZ/images/pages/developer-resources/feature-not-available.png?w=560\u0026fit=max\u0026auto=format\u0026n=N6Qn8nkrAkxXvrVZ\u0026q=85\u0026s=a6d25db2d61309649fdfad41d90248db 560w, https://mintcdn.com/bitgpt/N6Qn8nkrAkxXvrVZ/images/pages/developer-resources/feature-not-available.png?w=840\u0026fit=max\u0026auto=format\u0026n=N6Qn8nkrAkxXvrVZ\u0026q=85\u0026s=b2249f7a5e28e4b290e8b673378e7b5b 840w, https://mintcdn.com/bitgpt/N6Qn8nkrAkxXvrVZ/images/pages/developer-resources/feature-not-available.png?w=1100\u0026fit=max\u0026auto=format\u0026n=N6Qn8nkrAkxXvrVZ\u0026q=85\u0026s=0d6b56ff6e724ba6c22ed376b5199c60 1100w, https://mintcdn.com/bitgpt/N6Qn8nkrAkxXvrVZ/images/pages/developer-resources/feature-not-available.png?w=1650\u0026fit=max\u0026auto=format\u0026n=N6Qn8nkrAkxXvrVZ\u0026q=85\u0026s=c6f93b9b50a2d706573a4e115c5a5be0 1650w, https://mintcdn.com/bitgpt/N6Qn8nkrAkxXvrVZ/images/pages/developer-resources/feature-not-available.png?w=2500\u0026fit=max\u0026auto=format\u0026n=N6Qn8nkrAkxXvrVZ\u0026q=85\u0026s=2c5999f64cf0876dba9ca70391c70549 2500w`}),`\n`,_jsx(Heading,{level:`2`,id:`api-usage-in-sandbox`,children:`API Usage in Sandbox`}),`\n`,_jsxs(_components.p,{children:[`The API base URL for the Sandbox will stay the same, in order to send requests to the sandbox environment you’ll have to pass the `,_jsx(_components.code,{children:`X-Test-Mode`}),` header as `,_jsx(_components.code,{children:`true`})]})]})}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":"system","config":{},"pageMetadata":{"title":"Sandbox","sidebarTitle":"Sandbox","description":"Learn about the upcoming Sandbox environment for safe testing and integration.","icon":"flask-vial","href":"/developer-resources/get-started/sandbox"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Current Status","slug":"current-status","depth":2,"children":[]},{"title":"How It Will Work","slug":"how-it-will-work","depth":2,"children":[]},{"title":"What You’ll Be Able to Test","slug":"what-you’ll-be-able-to-test","depth":2,"children":[]},{"title":"API Usage in Sandbox","slug":"api-usage-in-sandbox","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"bitgpt","siteName":"BitGPT 402pay Documentation","title":"BitGPT 402pay Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2025-10-10T10:39:20.281Z","originalFileLocation":"developer-resources/get-started/sandbox.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=\"Learn about the upcoming Sandbox environment for safe testing and integration.\">\u003cmeta data-mint-head name=\"application-name\" content=\"BitGPT 402pay Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bitgpt/TXnqDz_1-WZcwU5O/_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=\"/mintlify-assets/_mintlify/favicons/bitgpt/TXnqDz_1-WZcwU5O/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bitgpt/TXnqDz_1-WZcwU5O/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/bitgpt/TXnqDz_1-WZcwU5O/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/bitgpt/TXnqDz_1-WZcwU5O/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bitgpt/TXnqDz_1-WZcwU5O/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bitgpt/TXnqDz_1-WZcwU5O/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/bitgpt/TXnqDz_1-WZcwU5O/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/bitgpt/TXnqDz_1-WZcwU5O/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"BitGPT 402pay Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"One platform to leverage blockchain-native payments for the future of commerce, agents and payments.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"BitGPT 402pay Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.bitgpt.xyz/developer-resources/get-started/sandbox\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://bitgpt.mintlify.app/images/og.png\">\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=\"BitGPT 402pay Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"One platform to leverage blockchain-native payments for the future of commerce, agents and payments.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://bitgpt.mintlify.app/images/og.png\">\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=\"/mintlify-assets/_mintlify/favicons/bitgpt/TXnqDz_1-WZcwU5O/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"BitGPT 402pay Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2E74FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.bitgpt.xyz/developer-resources/get-started/sandbox\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/developer-resources/get-started/sandbox.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.bitgpt.xyz/#organization\",\"name\":\"BitGPT 402pay Documentation\",\"url\":\"https://docs.bitgpt.xyz\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/bitgpt/N6Qn8nkrAkxXvrVZ/images/logo/light.png?fit=max\u0026auto=format\u0026n=N6Qn8nkrAkxXvrVZ\u0026q=85\u0026s=983649556b8a67d1d2025eaca748d434\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.bitgpt.xyz#website\",\"name\":\"BitGPT 402pay Documentation\",\"url\":\"https://docs.bitgpt.xyz\",\"publisher\":{\"@id\":\"https://docs.bitgpt.xyz/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.bitgpt.xyz/developer-resources/get-started/sandbox#webpage\",\"url\":\"https://docs.bitgpt.xyz/developer-resources/get-started/sandbox\",\"name\":\"Sandbox\",\"description\":\"Learn about the upcoming Sandbox environment for safe testing and integration.\",\"dateModified\":\"2025-10-10T10:39:20.281Z\",\"isPartOf\":{\"@id\":\"https://docs.bitgpt.xyz#website\"},\"breadcrumb\":{\"@id\":\"https://docs.bitgpt.xyz/developer-resources/get-started/sandbox#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.bitgpt.xyz/developer-resources/get-started/sandbox#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"GET STARTED\",\"item\":\"https://docs.bitgpt.xyz/developer-resources/get-started/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Sandbox\",\"item\":\"https://docs.bitgpt.xyz/developer-resources/get-started/sandbox\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.bitgpt.xyz/developer-resources/get-started/sandbox#article\",\"headline\":\"Sandbox\",\"name\":\"Sandbox\",\"description\":\"Learn about the upcoming Sandbox environment for safe testing and integration.\",\"url\":\"https://docs.bitgpt.xyz/developer-resources/get-started/sandbox\",\"mainEntityOfPage\":{\"@id\":\"https://docs.bitgpt.xyz/developer-resources/get-started/sandbox#webpage\"},\"image\":\"https://docs.bitgpt.xyz/images/og.png\",\"dateModified\":\"2025-10-10T10:39:20.281Z\",\"publisher\":{\"@id\":\"https://docs.bitgpt.xyz/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.bitgpt.xyz#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"BitGPT 402pay Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"BitGPT 402pay Documentation","nav":{"global":null,"tabs":[{"tab":"Get started","pages":[{"title":"Get started","href":"/basics/get-started/bitgpt"}]},{"tab":"Infrastructure","pages":[{"title":"Infrastructure","href":"/infrastructure/architecture"}]},{"tab":"Developer resources","groups":[{"group":"GET STARTED","pages":[{"title":"Introduction","sidebarTitle":"Introduction","icon":"arrow-right-to-arc","href":"/developer-resources/get-started/introduction"},{"title":"API Keys","sidebarTitle":"API Keys","icon":"key","href":"/developer-resources/get-started/api-keys"},{"title":"Authentication","sidebarTitle":"Authentication","description":"Learn how to authenticate using API keys and the correct headers.","icon":"lock","href":"/developer-resources/get-started/authentication"},{"title":"Sandbox","sidebarTitle":"Sandbox","icon":"flask-vial","href":"/developer-resources/get-started/sandbox"},{"title":"Errors","sidebarTitle":"Errors","description":"Learn how API errors work, what status codes mean, and how to handle them properly.","icon":"bomb","href":"/developer-resources/get-started/errors"},{"title":"Rate limits","sidebarTitle":"Rate limits","icon":"wave-pulse","href":"/developer-resources/get-started/rate-limits"},{"title":"Idempotency","sidebarTitle":"Idempotency","icon":"fingerprint","href":"/developer-resources/get-started/idempotency"},{"title":"Expanding Objects","sidebarTitle":"Expanding Objects","icon":"expand","href":"/developer-resources/get-started/expanding-objects"},{"title":"Providers and Gateways","sidebarTitle":"Providers and Gateways","icon":"receipt","href":"/developer-resources/get-started/providers-gateways"},{"title":"Metadata","sidebarTitle":"Metadata","icon":"database","href":"/developer-resources/get-started/metadata"}]},{"group":"WEBHOOKS","pages":[{"title":"Webhooks","sidebarTitle":"Overview","icon":"webhook","href":"/developer-resources/webhooks/overview"},{"title":"Events","sidebarTitle":"Events","icon":"list-tree","href":"/developer-resources/webhooks/events"},{"group":"Payloads","icon":"brackets-curly","pages":[{"group":"Invoices","icon":"receipt","pages":[{"title":"invoice.created","openapi":"developer-resources/reference/openapi.json webhook invoice.created","href":"/developer-resources/webhooks/events/invoices/invoice-created"},{"title":"invoice.updated","openapi":"developer-resources/reference/openapi.json webhook invoice.updated","href":"/developer-resources/webhooks/events/invoices/invoice-updated"},{"title":"invoice.completed","openapi":"developer-resources/reference/openapi.json webhook invoice.completed","href":"/developer-resources/webhooks/events/invoices/invoice-completed"},{"title":"invoice.cancelled","openapi":"developer-resources/reference/openapi.json webhook invoice.cancelled","href":"/developer-resources/webhooks/events/invoices/invoice-cancelled"}]},{"group":"Payments","icon":"credit-card","pages":[{"title":"payment.created","openapi":"developer-resources/reference/openapi.json webhook payment.created","href":"/developer-resources/webhooks/events/payments/payment-created"},{"title":"payment.updated","openapi":"developer-resources/reference/openapi.json webhook payment.updated","href":"/developer-resources/webhooks/events/payments/payment-updated"},{"title":"payment.completed","openapi":"developer-resources/reference/openapi.json webhook payment.completed","href":"/developer-resources/webhooks/events/payments/payment-completed"},{"title":"payment.cancelled","openapi":"developer-resources/reference/openapi.json webhook payment.cancelled","href":"/developer-resources/webhooks/events/payments/payment-cancelled"}]},{"group":"Products","icon":"conveyor-belt-arm","pages":[{"title":"product.created","openapi":"developer-resources/reference/openapi.json webhook product.created","href":"/developer-resources/webhooks/events/products/product-created"},{"title":"product.updated","openapi":"developer-resources/reference/openapi.json webhook product.updated","href":"/developer-resources/webhooks/events/products/product-updated"},{"title":"product.deleted","openapi":"developer-resources/reference/openapi.json webhook product.deleted","href":"/developer-resources/webhooks/events/products/product-deleted"}]},{"group":"API Keys","icon":"key","pages":[{"title":"api_key.created","openapi":"developer-resources/reference/openapi.json webhook api_key.created","href":"/developer-resources/webhooks/events/api_keys/api_key-created"},{"title":"api_key.updated","openapi":"developer-resources/reference/openapi.json webhook api_key.updated","href":"/developer-resources/webhooks/events/api_keys/api_key-updated"},{"title":"api_key.deleted","openapi":"developer-resources/reference/openapi.json webhook api_key.deleted","href":"/developer-resources/webhooks/events/api_keys/api_key-deleted"}]}]}]},{"group":"API REFERENCE","pages":[{"group":"Schemas","icon":"brackets-curly","pages":[{"title":"2xx Response","sidebarTitle":"2xx Response","icon":"brackets-curly","openapi":"/developer-resources/reference/openapi.json","href":"/developer-resources/schemas/response-200"},{"title":"Currency","sidebarTitle":"Currency","icon":"brackets-curly","openapi":"/developer-resources/reference/openapi.json","href":"/developer-resources/schemas/currency"},{"title":"Provider","sidebarTitle":"Provider","icon":"brackets-curly","openapi":"/developer-resources/reference/openapi.json","href":"/developer-resources/schemas/provider"},{"title":"Invoice","sidebarTitle":"Invoice","icon":"brackets-curly","openapi":"/developer-resources/reference/openapi.json","href":"/developer-resources/schemas/invoice"},{"title":"File","sidebarTitle":"File","icon":"brackets-curly","openapi":"/developer-resources/reference/openapi.json","href":"/developer-resources/schemas/file"},{"title":"Product","sidebarTitle":"Product","icon":"brackets-curly","openapi":"/developer-resources/reference/openapi.json","href":"/developer-resources/schemas/product"},{"title":"API Key","sidebarTitle":"API Key","icon":"brackets-curly","openapi":"/developer-resources/reference/openapi.json","href":"/developer-resources/schemas/api-key"},{"title":"Webhook","sidebarTitle":"Webhook","icon":"brackets-curly","openapi":"/developer-resources/reference/openapi.json","href":"/developer-resources/schemas/webhook"}]},{"group":"API Keys","icon":"key","pages":[{"openapi":"post /developers/api_keys","title":"Create a new API key","href":"/developer-resources/reference/api-keys/create-api-key"},{"openapi":"get /developers/api_keys/{id}","title":"Get an API key","href":"/developer-resources/reference/api-keys/get-api-key"},{"openapi":"put /developers/api_keys/{id}","title":"Update an API key","href":"/developer-resources/reference/api-keys/update-api-key"},{"openapi":"delete /developers/api_keys/{id}","title":"Delete an API key","href":"/developer-resources/reference/api-keys/delete-api-key"},{"openapi":"get /analytics/api_keys","title":"Get API key analytics","href":"/developer-resources/reference/api-keys/get-api-key-analytics"},{"openapi":"get /developers/api_keys/scopes","title":"List API key scopes","href":"/developer-resources/reference/api-keys/list-api-key-scopes"},{"openapi":"get /developers/api_keys","title":"List API keys","href":"/developer-resources/reference/api-keys/list-api-keys"}]},{"group":"Files","icon":"file","pages":[{"openapi":"post /files/upload","title":"Upload a file","href":"/developer-resources/reference/files/upload-a-file"},{"openapi":"get /files/{id}","title":"Get file details","href":"/developer-resources/reference/files/get-file-details"},{"openapi":"get /files","title":"List files","href":"/developer-resources/reference/files/list-files"},{"openapi":"delete /files/{id}","title":"Delete file","href":"/developer-resources/reference/files/delete-file"}]},{"group":"Payments and Invoices","icon":"receipt","pages":[{"openapi":"post /analytics/dashboard","title":"Get dashboard analytics","href":"/developer-resources/reference/payments/analytics"},{"openapi":"post /invoices/create","title":"Create an invoice","href":"/developer-resources/reference/payments/create-an-invoice"},{"openapi":"put /invoices/{id}","title":"Update invoice","href":"/developer-resources/reference/payments/update-an-invoice"},{"openapi":"post /invoices/{id}","title":"Get invoice details","href":"/developer-resources/reference/payments/get-invoice-details"},{"openapi":"get /invoices/{id}/short_state","title":"Get invoice short state","href":"/developer-resources/reference/payments/get-invoice-short-state"},{"openapi":"get /providers/{invoice_id}","title":"Get invoice providers","href":"/developer-resources/reference/payments/get-invoice-providers"},{"openapi":"post /invoices/list","title":"List invoices","href":"/developer-resources/reference/payments/list-invoices"},{"openapi":"post /payments","title":"List payments","href":"/developer-resources/reference/payments/list-payments"},{"openapi":"post /payments/{id}","title":"Get payment details","href":"/developer-resources/reference/payments/get-payment-details"},{"openapi":"put /payments/{id}","title":"Update payment","href":"/developer-resources/reference/payments/update-a-payment"},{"openapi":"post /pay/quote","title":"Quote payment","href":"/developer-resources/reference/payments/quote-payment"},{"openapi":"post /invoices/validate","title":"Validate invoice data","href":"/developer-resources/reference/payments/validate-invoice-data"}]},{"group":"Products","icon":"conveyor-belt-arm","pages":[{"openapi":"post /products","title":"Create a new product","href":"/developer-resources/reference/products/create-a-new-product"},{"openapi":"get /products/{id}","title":"Get a product","href":"/developer-resources/reference/products/get-a-product"},{"openapi":"get /products","title":"List products","href":"/developer-resources/reference/products/list-products"},{"openapi":"put /products/{id}","title":"Update a product","href":"/developer-resources/reference/products/update-a-product"}]},{"group":"Webhooks","icon":"webhook","pages":[{"openapi":"post /developers/webhooks","title":"Create a new webhook","href":"/developer-resources/reference/webhooks/create-a-new-webhook"},{"openapi":"get /developers/webhooks/{id}","title":"Get a webhook","href":"/developer-resources/reference/webhooks/get-a-webhook"},{"openapi":"get /analytics/webhooks","title":"Get webhook analytics","href":"/developer-resources/reference/webhooks/get-webhook-analytics"},{"openapi":"get /analytics/webhooks/{id}","title":"Get webhook analytics by ID","href":"/developer-resources/reference/webhooks/get-webhook-analytics-by-id"},{"openapi":"get /developers/webhooks/events","title":"Get webhook events","href":"/developer-resources/reference/webhooks/get-webhook-events"},{"openapi":"get /developers/webhooks","title":"List webhooks","href":"/developer-resources/reference/webhooks/list-webhooks"},{"openapi":"get /developers/webhooks/queue","title":null,"href":"/developer-resources/reference/webhooks/list-webhook-queue-items"},{"openapi":"post /developers/webhooks/queue/{id}/retry","title":"Retry a webhook queue item","href":"/developer-resources/reference/webhooks/retry-a-webhook-queue-item"},{"openapi":"put /developers/webhooks/{id}","title":"Update a webhook","href":"/developer-resources/reference/webhooks/update-a-webhook"},{"openapi":"delete /developers/webhooks/{id}","title":"Delete a webhook","href":"/developer-resources/reference/webhooks/delete-a-webhook"}]}]}]},{"tab":"Recipes","pages":[{"title":"Recipes","href":"/recipes/overview"}]},{"tab":"HTTP 402","pages":[{"title":"HTTP 402","href":"/h402/introduction"}]}]},"basePath":"","title":"BitGPT 402pay Documentation","buildId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","deploymentId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-DW6UFrUy.js","DynamicMarkdown-B62XqCSI.js","zoom-image-lightbox-eHyQ0tlO.js","lightbox-handle-r17bVUz3.js"]}