{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Xerobi Docs","colors":{"primary":"#0075de","light":"#0075de","dark":"#0075de"},"logo":{"light":"https://mintcdn.com/xerobi/tJw8OvbvcyLM9-rR/logo/logo-dark.svg?fit=max\u0026auto=format\u0026n=tJw8OvbvcyLM9-rR\u0026q=85\u0026s=dd6906b06fdb13cc1f8563374372ee0b","dark":"https://mintcdn.com/xerobi/tJw8OvbvcyLM9-rR/logo/logo-light.svg?fit=max\u0026auto=format\u0026n=tJw8OvbvcyLM9-rR\u0026q=85\u0026s=a2b87bb53ba49dc7a7ea8f17a3e453e8"},"favicon":"https://mintcdn.com/xerobi/tJw8OvbvcyLM9-rR/favicon.svg?fit=max\u0026auto=format\u0026n=tJw8OvbvcyLM9-rR\u0026q=85\u0026s=7945c9b595a7466509465e34aaf2300c","background":{"color":{"light":"#ffffff","dark":"#191919"}},"navbar":{"primary":{"type":"button","label":"Visit Site","href":"https://www.xerobi.com"}},"footer":{"socials":{"x":"https://x.com/xerobihq","github":"https://github.com/xerobi","linkedin":"https://linkedin.com/company/xerobi"},"links":[{"header":"Company","items":[{"label":"Blog","href":"https://blog.xerobi.com"},{"label":"Careers","href":"https://www.xerobi.com/careers"}]}]},"fonts":{"family":"Inter","weight":500},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","latex":true},"integrations":{"gtm":{"tagId":"GTM-NSSGLJ96"}},"errors":{"404":{"redirect":false,"title":"I can't be found","description":"What ever **happened** to this _page_?"}},"contextual":{"options":["copy","view","chatgpt","claude","mcp"],"display":"header"},"navigation":{"global":{"anchors":[{"anchor":"Blog","icon":"newspaper","href":"https://blog.xerobi.com/"},{"anchor":"Support","icon":"hand-helping","href":"https://support.xerobi.com/"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"xerobi","hasAudioNarration":false,"actualSubdomain":"xerobi","customDomains":["docs.xerobi.com"],"gitSource":{"type":"github","owner":"xerobi","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":"","_id":"6aeabf50b5f58aae7efb90e7"},"chroma":{"latestBuiltDeploymentHistoryId":"6aead97e9f475c823514c4a0","collectionId":"d5320ce1-b17a-4004-9120-2fbf90d7b558","liveDeploymentHistoryId":"6aead97e9f475c823514c4a0","schemaVersion":"v3"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aeadc87cd0851bf5f65781b","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"default","tag":"Network API","count":37},{"language":"default","tag":"Payment Gateway","count":18},{"language":"default","tag":"SMS Gateway","count":18},{"language":"default","tag":"Speed Test API","count":18},{"language":"default","tag":"Certification \u0026 Badge","count":13},{"language":"default","tag":"FAQ \u0026 Guides","count":13},{"language":"default","tag":"Webhooks","count":9},{"language":"default","tag":"API FAQs","count":6},{"language":"default","tag":"Templates","count":5},{"language":"default","tag":"Payment Intents","count":5}],"searchSettings":{"maxResults":10,"showContentSnippets":true,"fullPageSearch":false,"isFiltersEnabled":true}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"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":"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":"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},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":true}},"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"footer{padding-bottom:2rem!important}"}],"page":{"pagePath":"payment-api/endpoint/create-payment-intent","slug":"/payment-api/endpoint/create-payment-intent","pageMetadata":{"title":"Create Payment Intent","openapi":"POST /payment_intents","description":"Create a PaymentIntent to begin the payment flow. Use `Idempotency-Key` header to make this request idempotent.","href":"/payment-api/endpoint/create-payment-intent"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Create a PaymentIntent to begin the payment flow. Use \", _jsx(_components.code, {\n children: \"Idempotency-Key\"\n }), \" header to make this request idempotent.\"]\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create Payment Intent","openapi":"POST /payment_intents","description":"Create a PaymentIntent to begin the payment flow. Use `Idempotency-Key` header to make this request idempotent.","href":"/payment-api/endpoint/create-payment-intent"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/xerobi/40b3fcdd569f4154/gtm.js","/_mintlify/custom/xerobi/14ac15f1d7267fc4/hide.js"],"openApiReferenceData":{"operation":{"tags":["PaymentIntents"],"summary":"Create a PaymentIntent","description":"Create a PaymentIntent to begin the payment flow. Use `Idempotency-Key` header to make this request idempotent.","operationId":"createPaymentIntent","parameters":["8c6233a9-9d9a-4bf8-9359-36c8c42e7856","fba58d44-7d16-46e4-add1-802582ec288a","0d506aa1-c50b-4869-9f4b-82a0f135d227"],"requestBody":"37c7c453-8321-4700-8ce7-fe5c0718ea4c","responses":{"201":"b85d8031-449b-458c-8f44-9af9ec1b694c","400":"54ed662c-a900-48d2-9cf8-46ff46c608d4","401":"a4d8ac3b-ee4a-4b19-b54b-7e3a53090370","409":"3ccce3a5-8bcd-4864-a611-5b2f3bf1ebdd"},"method":"post","type":"path","servers":["88d3e646-421e-4e10-8e5c-ed821e235789","bdf181f8-9197-474b-a2bf-2b1d8ad26f74"],"security":["043f57f2-95e0-4c30-8047-2c9a8e5f5c8d"],"path":"/payment_intents","baseUrlOptions":["https://sandbox.api.hixbe.com/payment","https://api.hixbe.com/payment"],"title":"Create a PaymentIntent","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"8c6233a9-9d9a-4bf8-9359-36c8c42e7856":{"name":"Xerobi-Version","in":"header","description":"API version header. Use '2026-01-01' for the latest version.","required":true,"schema":{"type":"string","default":"2026-01-01","isRequired":true,"description":"API version header. Use '2026-01-01' for the latest version.","uniqueKey":"","typeLabel":"string"}},"fba58d44-7d16-46e4-add1-802582ec288a":{"name":"Idempotency-Key","in":"header","description":"Idempotency key for safely retrying POST requests.","required":false,"schema":{"type":"string","isRequired":false,"description":"Idempotency key for safely retrying POST requests.","uniqueKey":"","typeLabel":"string"}},"0d506aa1-c50b-4869-9f4b-82a0f135d227":{"name":"X-Request-Id","in":"header","description":"Optional client-provided request id for tracing.","required":false,"schema":{"type":"string","isRequired":false,"description":"Optional client-provided request id for tracing.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"amount":{"type":"integer","example":1500,"isRequired":true,"uniqueKey":"amount","typeLabel":"integer"},"currency":{"type":"string","example":"BDT","isRequired":true,"uniqueKey":"currency","typeLabel":"string"},"customer":{"type":"string","uniqueKey":"customer","typeLabel":"string"},"automatic_payment_methods":{"type":"boolean","default":true,"uniqueKey":"automatic_payment_methods","typeLabel":"boolean"},"capture_method":{"type":"string","enum":["automatic","manual"],"default":"automatic","uniqueKey":"capture_method","typeLabel":"enum\u003cstring>"},"metadata":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"metadata.additionalProperties","typeLabel":"string"},"uniqueKey":"metadata","typeLabel":"object"}},"required":["amount","currency"],"uniqueKey":"","typeLabel":"object"},"example":{"amount":1500,"currency":"BDT","customer":"cus_123","automatic_payment_methods":true,"metadata":{"order_id":"ORD-32"}},"examples":{"Example":{"title":"Example","value":{"amount":1500,"currency":"BDT","customer":"cus_123","automatic_payment_methods":true,"metadata":{"order_id":"ORD-32"}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"b85d8031-449b-458c-8f44-9af9ec1b694c":{"description":"Payment intent created","content":{"application/json":{"schema":{"type":"object","description":"Represents an intent to collect payment from a customer. Use confirm to finalize.","properties":{"id":{"type":"string","example":"pi_1Hh1X2AbCdEf","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"amount":{"type":"integer","description":"Amount in smallest currency unit","example":1500,"isRequired":true,"uniqueKey":"amount","typeLabel":"integer"},"currency":{"type":"string","example":"BDT","isRequired":true,"uniqueKey":"currency","typeLabel":"string"},"status":{"type":"string","enum":["requires_payment_method","requires_confirmation","processing","succeeded","requires_action","canceled"],"example":"requires_payment_method","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"client_secret":{"type":"string","description":"Client-side secret used by frontends","example":"cs_test_abc","isRequired":true,"uniqueKey":"client_secret","typeLabel":"string"},"object":{"type":"string","example":"payment_intent","uniqueKey":"object","typeLabel":"string"},"capture_method":{"type":"string","enum":["automatic","manual"],"example":"automatic","uniqueKey":"capture_method","typeLabel":"enum\u003cstring>"},"customer":{"oneOf":[{"type":"string","example":"cus_123","uniqueKey":"customer.oneOf.0","typeLabel":"string"},{"type":"null","example":"cus_123","uniqueKey":"customer.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer","typeLabel":"string | null"},"payment_method":{"oneOf":[{"type":"string","example":"pm_card_abc","uniqueKey":"payment_method.oneOf.0","typeLabel":"string"},{"type":"null","example":"pm_card_abc","uniqueKey":"payment_method.oneOf.1","typeLabel":"null"}],"uniqueKey":"payment_method","typeLabel":"string | null"},"metadata":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"metadata.additionalProperties","typeLabel":"string"},"uniqueKey":"metadata","typeLabel":"object"},"created_at":{"type":"string","format":"date-time","uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","uniqueKey":"updated_at","typeLabel":"string\u003cdate-time>"},"charges":{"type":"array","items":{"type":"object","description":"Represents an actual charge produced when a payment succeeds.","properties":{"id":{"type":"string","example":"ch_1Hh2Z3AbCdEf","isRequired":true,"uniqueKey":"charges.items.[INDEX].id","typeLabel":"string"},"amount":{"type":"integer","example":1500,"isRequired":true,"uniqueKey":"charges.items.[INDEX].amount","typeLabel":"integer"},"currency":{"type":"string","example":"BDT","isRequired":true,"uniqueKey":"charges.items.[INDEX].currency","typeLabel":"string"},"status":{"type":"string","enum":["pending","succeeded","failed","refunded"],"example":"succeeded","isRequired":true,"uniqueKey":"charges.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"payment_method":{"type":"string","uniqueKey":"charges.items.[INDEX].payment_method","typeLabel":"string"},"receipt_url":{"type":"string","format":"uri","uniqueKey":"charges.items.[INDEX].receipt_url","typeLabel":"string\u003curi>"},"created_at":{"type":"string","format":"date-time","uniqueKey":"charges.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"}},"required":["id","amount","currency","status"],"uniqueKey":"charges.items.[INDEX]","typeLabel":"object"},"uniqueKey":"charges","typeLabel":"object[]"}},"required":["id","amount","currency","status","client_secret"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"pi_1Hh1X2AbCdEf","amount":1500,"currency":"BDT","status":"requires_payment_method","client_secret":"cs_test_abc","object":"payment_intent","capture_method":"automatic","customer":"cus_123","payment_method":"pm_card_abc","metadata":{},"created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z","charges":[{"id":"ch_1Hh2Z3AbCdEf","amount":1500,"currency":"BDT","status":"succeeded","payment_method":"\u003cstring>","receipt_url":"\u003cstring>","created_at":"2023-11-07T05:31:56Z"}]}}},"exampleType":"generated"}},"headers":{"X-Request-Id":{"description":"Gateway request id","schema":{"type":"string"}},"X-API-Version":{"description":"API version served","schema":{"type":"string"}}},"exampleType":"generated"},"54ed662c-a900-48d2-9cf8-46ff46c608d4":{"description":"Standard error response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"category (invalid_request, auth_error, processing_error, rate_limit, internal_error)","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","description":"machine-friendly error code","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"human-friendly message","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"type":"string","description":"request parameter related to the error, if any","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"request parameter related to the error, if any","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"request_id":{"type":"string","description":"gateway generated request id for debugging","uniqueKey":"error.request_id","typeLabel":"string"}},"required":["type","code","message"],"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","param":"\u003cstring>","request_id":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"a4d8ac3b-ee4a-4b19-b54b-7e3a53090370":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"category (invalid_request, auth_error, processing_error, rate_limit, internal_error)","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","description":"machine-friendly error code","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"human-friendly message","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"type":"string","description":"request parameter related to the error, if any","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"request parameter related to the error, if any","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"request_id":{"type":"string","description":"gateway generated request id for debugging","uniqueKey":"error.request_id","typeLabel":"string"}},"required":["type","code","message"],"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","param":"\u003cstring>","request_id":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"3ccce3a5-8bcd-4864-a611-5b2f3bf1ebdd":{"description":"Idempotency conflict - request previously completed with different payload","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"category (invalid_request, auth_error, processing_error, rate_limit, internal_error)","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","description":"machine-friendly error code","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"human-friendly message","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"type":"string","description":"request parameter related to the error, if any","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"request parameter related to the error, if any","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"request_id":{"type":"string","description":"gateway generated request id for debugging","uniqueKey":"error.request_id","typeLabel":"string"}},"required":["type","code","message"],"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","param":"\u003cstring>","request_id":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"043f57f2-95e0-4c30-8047-2c9a8e5f5c8d":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Use your secret API key. Example: `Authorization: Bearer sk_test_xxx`","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"88d3e646-421e-4e10-8e5c-ed821e235789":{"url":"https://sandbox.api.hixbe.com/payment","description":"Sandbox (test)"},"bdf181f8-9197-474b-a2bf-2b1d8ad26f74":{"url":"https://api.hixbe.com/payment","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Use your secret API key. Example: `Authorization: Bearer sk_test_xxx`","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Use your secret API key. Example: `Authorization: Bearer sk_test_xxx`","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"payment-api/openapi.json"},"subdomain":"xerobi","siteName":"Xerobi Docs","title":"Create Payment Intent - Xerobi Docs","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"automatic"},"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-04T06:51:15.870Z","originalFileLocation":"payment-api/endpoint/create-payment-intent.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=\"Create a PaymentIntent to begin the payment flow. Use Idempotency-Key header to make this request idempotent.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Xerobi Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/xerobi/OjfKw9WB3N7YHU2u/_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/xerobi/OjfKw9WB3N7YHU2u/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/xerobi/OjfKw9WB3N7YHU2u/_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/xerobi/OjfKw9WB3N7YHU2u/_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/xerobi/OjfKw9WB3N7YHU2u/_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/xerobi/OjfKw9WB3N7YHU2u/_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/xerobi/OjfKw9WB3N7YHU2u/_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/xerobi/OjfKw9WB3N7YHU2u/_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/xerobi/OjfKw9WB3N7YHU2u/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Payment Intent - Xerobi Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a PaymentIntent to begin the payment flow. Use Idempotency-Key header to make this request idempotent.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Xerobi Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.xerobi.com/payment-api/endpoint/create-payment-intent\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://xerobi.mintlify.app/_mintlify/api/og/v2?division=Payment+Intents\u0026amp;title=Create+Payment+Intent\u0026amp;description=Create+a+PaymentIntent+to+begin+the+payment+flow.+Use+%60Idempotency-Key%60+header+to+make+this+request+idempotent.\u0026amp;theme=ade9e42e4c3c5d0daa361b3a\u0026amp;signature=3245abf8373ced387794db73a915edb48aec5ada2aae5482b69e01271a4edf0b\">\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=\"Create Payment Intent - Xerobi Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a PaymentIntent to begin the payment flow. Use Idempotency-Key header to make this request idempotent.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://xerobi.mintlify.app/_mintlify/api/og/v2?division=Payment+Intents\u0026amp;title=Create+Payment+Intent\u0026amp;description=Create+a+PaymentIntent+to+begin+the+payment+flow.+Use+%60Idempotency-Key%60+header+to+make+this+request+idempotent.\u0026amp;theme=ade9e42e4c3c5d0daa361b3a\u0026amp;signature=3245abf8373ced387794db73a915edb48aec5ada2aae5482b69e01271a4edf0b\">\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/xerobi/OjfKw9WB3N7YHU2u/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Xerobi Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0075de\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.xerobi.com/payment-api/endpoint/create-payment-intent\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/payment-api/endpoint/create-payment-intent.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.xerobi.com/#organization\",\"name\":\"Xerobi Docs\",\"url\":\"https://docs.xerobi.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/xerobi/tJw8OvbvcyLM9-rR/logo/logo-dark.svg?fit=max\u0026auto=format\u0026n=tJw8OvbvcyLM9-rR\u0026q=85\u0026s=dd6906b06fdb13cc1f8563374372ee0b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.xerobi.com#website\",\"name\":\"Xerobi Docs\",\"url\":\"https://docs.xerobi.com\",\"publisher\":{\"@id\":\"https://docs.xerobi.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.xerobi.com/payment-api/endpoint/create-payment-intent#webpage\",\"url\":\"https://docs.xerobi.com/payment-api/endpoint/create-payment-intent\",\"name\":\"Create Payment Intent\",\"description\":\"Create a PaymentIntent to begin the payment flow. Use Idempotency-Key header to make this request idempotent.\",\"dateModified\":\"2026-11-04T06:51:15.870Z\",\"isPartOf\":{\"@id\":\"https://docs.xerobi.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.xerobi.com/payment-api/endpoint/create-payment-intent#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.xerobi.com/payment-api/endpoint/create-payment-intent#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Xerobi Docs\",\"item\":\"https://docs.xerobi.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create Payment Intent\",\"item\":\"https://docs.xerobi.com/payment-api/endpoint/create-payment-intent\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.xerobi.com/payment-api/endpoint/create-payment-intent#apireference\",\"headline\":\"Create Payment Intent\",\"name\":\"Create Payment Intent\",\"description\":\"Create a PaymentIntent to begin the payment flow. Use Idempotency-Key header to make this request idempotent.\",\"url\":\"https://docs.xerobi.com/payment-api/endpoint/create-payment-intent\",\"mainEntityOfPage\":{\"@id\":\"https://docs.xerobi.com/payment-api/endpoint/create-payment-intent#webpage\"},\"dateModified\":\"2026-11-04T06:51:15.870Z\",\"publisher\":{\"@id\":\"https://docs.xerobi.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.xerobi.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Xerobi Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Xerobi Docs","nav":{"global":{"anchors":[{"anchor":"Blog","icon":"newspaper","href":"https://blog.xerobi.com/"},{"anchor":"Support","icon":"hand-helping","href":"https://support.xerobi.com/"}]},"tabs":[{"tab":"FAQ \u0026 Guides","pages":[{"title":"FAQ \u0026 Guides","href":""}]},{"tab":"Payment Gateway","groups":[{"group":"Overview","pages":[{"title":"Xerobi Payment API Introduction","description":"Xerobi Payment API - A developer-first REST API for a modern payment gateway","href":"/payment-api/introduction"}]},{"group":"Payment Intents","pages":[{"title":"Create Payment Intent","openapi":"POST /payment_intents","href":"/payment-api/endpoint/create-payment-intent"},{"title":"List Payment Intents","openapi":"GET /payment_intents","description":"List PaymentIntents with optional filtering and pagination.","href":"/payment-api/endpoint/list-payment-intents"},{"title":"Retrieve Payment Intent","openapi":"GET /payment_intents/{id}","href":"/payment-api/endpoint/retrieve-payment-intent"},{"title":"Attach Payment Method to Payment Intent","openapi":"POST /payment_intents/{id}/attach","href":"/payment-api/endpoint/attach-payment-method-to-intent"},{"title":"Confirm Payment Intent","openapi":"POST /payment_intents/{id}/confirm","href":"/payment-api/endpoint/confirm-payment-intent"}]},{"group":"Payment Methods","pages":[{"title":"Create Payment Method","openapi":"POST /payment_methods","href":"/payment-api/endpoint/create-payment-method"},{"title":"Retrieve Payment Method","openapi":"GET /payment_methods/{id}","href":"/payment-api/endpoint/retrieve-payment-method"}]},{"group":"Customers","pages":[{"title":"Create Customer","openapi":"POST /customers","href":"/payment-api/endpoint/create-customer"},{"title":"List Customers","openapi":"GET /customers","href":"/payment-api/endpoint/list-customers"},{"title":"Retrieve Customer","openapi":"GET /customers/{id}","href":"/payment-api/endpoint/retrieve-customer"},{"title":"Attach Payment Method to Customer","openapi":"POST /customers/{id}/payment_methods","href":"/payment-api/endpoint/attach-payment-method-to-customer"}]},{"group":"Refunds","pages":[{"title":"Create Refund","openapi":"POST /refunds","href":"/payment-api/endpoint/create-refund"},{"title":"Retrieve Refund","openapi":"GET /refunds/{id}","href":"/payment-api/endpoint/retrieve-refund"}]},{"group":"Webhooks","pages":[{"title":"Create Webhook Endpoint","openapi":"POST /webhooks","href":"/payment-api/endpoint/create-webhook-endpoint"},{"title":"List Webhook Endpoints","openapi":"GET /webhooks","href":"/payment-api/endpoint/list-webhook-endpoints"},{"title":"List Event Deliveries","openapi":"GET /events/{id}/deliveries","href":"/payment-api/endpoint/list-event-deliveries"}]},{"group":"Utilities","pages":[{"title":"Get Request Trace","openapi":"GET /observability/request/{request_id}","href":"/payment-api/endpoint/get-request-trace"}]}]},{"tab":"SMS Gateway","pages":[{"title":"SMS Gateway","href":"/sms-api/introduction"}]},{"tab":"Certification \u0026 Badge","pages":[{"title":"Certification \u0026 Badge","href":"/certify/introduction"}]},{"tab":"Network API","pages":[{"title":"Network API","href":"/network-api/introduction"}]},{"tab":"More","pages":[{"title":"More","href":"/more/ntp-servers"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Create Payment Intent - Xerobi Docs","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C8RPHPxo.js","utils-0BK-9q6z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DfjzsUJT.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B4v9psJ4.js","snippetPresets-CpTQv-Ez.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BNP-Fvr0.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BSgu6h1D.js","shallow-Biv1i9Gs.js","getApiPlaygroundDisplay-BoGOXhtF.js","CodeSnippet-DvQoT18_.js","CodeSnippets-Dnpa15xT.js","Page-Buji1S4J.js","getPastedJson-xAIyhUFE.js","icon-S6FBih11.js","MethodPill-SaYeUZyk.js","DuplicateIcon-Cs-p3v2Q.js","createIcon-DjCFEoHq.js","DynamicMarkdown-BcnBltEQ.js","SectionHeading-BUBl0eEF.js","axios-vUo_bRtp.js","Markdown-h4cOoD8d.js","clsx-B2v50t8t.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DJnKvr0g.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BHrrjR1K.js"]}