Orders a new card for the authenticated user. This endpoint initiates the card provisioning process and returns immediately upon successful acceptance of the order.
Prerequisites:
User must have VERIFIED status (completed KYC)
User must not have an existing card
Currently, only VIRTUAL cards are supported. Physical card ordering will be available in a future release.
Error:400 Bad RequestCause: User has not completed KYC verificationSolution: Complete user verification before ordering a card. Check user status with GET /v1/user/profile
User Already Has Card
Error:400 Bad RequestMessage:"User already has a card"Cause: User already has an existing cardSolution: Use GET /v1/card/status to retrieve existing card details instead of ordering a new one
Invalid Card Type
Error:422 Validation ErrorCause: Invalid value provided for type fieldSolution: Ensure the type field is set to VIRTUAL. Physical cards are not yet supported.
Missing Authentication
Error:401 UnauthorizedCause: Missing or invalid Bearer tokenSolution: Ensure you include a valid access token in the Authorization header
GET /v1/card/status - Check card status and details
POST /v1/card/details/token - Generate token to view card details
POST /v1/card/set-pin/token - Generate token to set card PIN
POST /v1/card/freeze - Temporarily disable card
GET /v1/user/profile - Check user verification status
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Baanx API","colors":{"primary":"#0D9373","light":"#07C983","dark":"#0D9373"},"favicon":"https://mintcdn.com/baanxgroup/gdsc8t7WiEeGHqE_/favicon.svg?fit=max\u0026auto=format\u0026n=gdsc8t7WiEeGHqE_\u0026q=85\u0026s=2ba01309dbb7993a37c43420e80054cd","navbar":{"links":[{"href":"mailto:support@baanx.com","label":"Support"}]},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"baanxgroup","hasAudioNarration":false,"actualSubdomain":"baanxgroup","customDomains":["docs.baanx.com"],"gitSource":{"type":"github","owner":"baanx-group","repo":"api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ae93ff587cae518f4656895:success","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"API Reference","count":75},{"language":"default","tag":"Documentation","count":40},{"language":"default","tag":"Wallet","count":19},{"language":"default","tag":"Authentication","count":17},{"language":"default","tag":"Webhooks","count":16},{"language":"default","tag":"Consent","count":11},{"language":"default","tag":"Delegation","count":10},{"language":"default","tag":"Card","count":9},{"language":"default","tag":"Wallets","count":9},{"language":"default","tag":"Card Operations","count":6}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"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},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/card/order","slug":"/api-reference/card/order","pageMetadata":{"title":"Order a Card","api":"POST https://dev.api.baanx.com/v1/card/order","description":"Order a new card for the authenticated user","href":"/api-reference/card/order","hidden":false},"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: \"Order a new card for the authenticated user\"\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={code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,CodeBlock,CodeGroup,Heading,Info,Note,ParamField,ResponseField,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsx(_components.p,{children:`Orders a new card for the authenticated user. This endpoint initiates the card provisioning process and returns immediately upon successful acceptance of the order.`}),`\n`,_jsxs(Note,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`Prerequisites:`})}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`User must have `,_jsx(_components.strong,{children:`VERIFIED`}),` status (completed KYC)`]}),`\n`,_jsx(_components.li,{children:`User must not have an existing card`}),`\n`]})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Currently, only `,_jsx(_components.strong,{children:`VIRTUAL`}),` cards are supported. Physical card ordering will be available in a future release.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`authentication`,children:`Authentication`}),`\n`,_jsx(_components.p,{children:`This endpoint requires authentication via Bearer token:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`Authorization:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` Bearer`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` YOUR_ACCESS_TOKEN`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`request`,children:`Request`}),`\n`,_jsx(Heading,{level:`3`,id:`headers`,children:`Headers`}),`\n`,_jsx(ParamField,{header:`x-client-key`,type:`string`,required:true,id:`param-x-client-key`,children:_jsx(_components.p,{children:`Your public API client key`})}),`\n`,_jsx(ParamField,{header:`x-us-env`,type:`boolean`,default:false,id:`param-x-us-env`,children:_jsxs(_components.p,{children:[`Set to `,_jsx(_components.code,{children:`true`}),` to route requests to the US backend environment`]})}),`\n`,_jsx(ParamField,{header:`Authorization`,type:`string`,required:true,id:`param-authorization`,children:_jsx(_components.p,{children:`Bearer token for authentication`})}),`\n`,_jsx(Heading,{level:`3`,id:`body`,children:`Body`}),`\n`,_jsxs(ParamField,{body:`type`,type:`string`,required:true,id:`param-type`,children:[_jsxs(_components.p,{children:[`The type of card to order. Currently only supports `,_jsx(_components.code,{children:`VIRTUAL`})]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Accepted Values:`})}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`VIRTUAL`}),` - Digital card for online and mobile payments`]}),`\n`]})]}),`\n`,_jsx(Heading,{level:`3`,id:`request-example`,children:`Request Example`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`7`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://dev.api.baanx.com/v1/card/order`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-client-key: YOUR_CLIENT_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer YOUR_ACCESS_TOKEN\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"type\": \"VIRTUAL\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`JavaScript`,numberOfLines:`14`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`14`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'https://dev.api.baanx.com/v1/card/order'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` method:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'POST'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'x-client-key'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'YOUR_CLIENT_KEY'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Authorization'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Bearer YOUR_ACCESS_TOKEN'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'application/json'`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` body:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` JSON`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`stringify`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` type:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'VIRTUAL'`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` })`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` data`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`14`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`14`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`url `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://dev.api.baanx.com/v1/card/order\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`headers `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-client-key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"YOUR_CLIENT_KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Bearer YOUR_ACCESS_TOKEN\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"application/json\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`payload `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"VIRTUAL\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`response `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.post(url, `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`headers, `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`json`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`payload)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(response.json())`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`TypeScript`,numberOfLines:`27`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`27`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`interface`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#4EC9B0`},children:` OrderCardRequest`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` type`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'VIRTUAL'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`interface`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#4EC9B0`},children:` OrderCardResponse`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` success`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:` boolean`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` orderCard`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` async`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ()`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#4EC9B0`},children:` Promise`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`\u003c`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#4EC9B0`},children:`OrderCardResponse`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`> `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`=>`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'https://dev.api.baanx.com/v1/card/order'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` method:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'POST'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'x-client-key'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'YOUR_CLIENT_KEY'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Authorization'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Bearer YOUR_ACCESS_TOKEN'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'application/json'`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` body:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` JSON`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`stringify`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` type:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'VIRTUAL'`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` })`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` });`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`!`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`ok`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` throw`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` Error`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`HTTP error! status: \"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`response`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`status`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` return`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`};`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(Heading,{level:`3`,id:`success-response`,children:`Success Response`}),`\n`,_jsx(ResponseField,{name:`success`,type:`boolean`,id:`param-success`,children:_jsx(_components.p,{children:`Indicates whether the card order was accepted successfully`})}),`\n`,`\n`,_jsx(Heading,{level:`2`,id:`error-responses`,children:`Error Responses`}),`\n`,`\n`,_jsx(Heading,{level:`2`,id:`common-error-scenarios`,children:`Common Error Scenarios`}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`User Not Verified`,id:`user-not-verified`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Error:`}),` `,_jsx(_components.code,{children:`400 Bad Request`})]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Cause:`}),` User has not completed KYC verification`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Solution:`}),` Complete user verification before ordering a card. Check user status with `,_jsx(_components.code,{children:`GET /v1/user/profile`})]})]}),_jsxs(Accordion,{title:`User Already Has Card`,id:`user-already-has-card`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Error:`}),` `,_jsx(_components.code,{children:`400 Bad Request`})]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Message:`}),` `,_jsx(_components.code,{children:`\"User already has a card\"`})]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Cause:`}),` User already has an existing card`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Solution:`}),` Use `,_jsx(_components.code,{children:`GET /v1/card/status`}),` to retrieve existing card details instead of ordering a new one`]})]}),_jsxs(Accordion,{title:`Invalid Card Type`,id:`invalid-card-type`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Error:`}),` `,_jsx(_components.code,{children:`422 Validation Error`})]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Cause:`}),` Invalid value provided for `,_jsx(_components.code,{children:`type`}),` field`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Solution:`}),` Ensure the `,_jsx(_components.code,{children:`type`}),` field is set to `,_jsx(_components.code,{children:`VIRTUAL`}),`. Physical cards are not yet supported.`]})]}),_jsxs(Accordion,{title:`Missing Authentication`,id:`missing-authentication`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Error:`}),` `,_jsx(_components.code,{children:`401 Unauthorized`})]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Cause:`}),` Missing or invalid Bearer token`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Solution:`}),` Ensure you include a valid access token in the Authorization header`]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next Steps`}),`\n`,_jsx(_components.p,{children:`After successfully ordering a card:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Check Card Status:`}),` Use `,_jsx(_components.code,{children:`GET /v1/card/status`}),` to monitor the card provisioning status`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`View Card Details:`}),` Once active, use `,_jsx(_components.code,{children:`POST /v1/card/details/token`}),` to generate a secure token for displaying sensitive card information`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Set PIN:`}),` Use `,_jsx(_components.code,{children:`POST /v1/card/set-pin/token`}),` to allow the user to set their card PIN`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Fund Card:`}),` In custodial environments, link a wallet to the card for funding transactions`]}),`\n`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`Card provisioning typically completes within a few seconds. The card status will change from `,_jsx(_components.code,{children:`PENDING`}),` to `,_jsx(_components.code,{children:`ACTIVE`}),` once ready for use.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`implementation-notes`,children:`Implementation Notes`}),`\n`,_jsx(Heading,{level:`3`,id:`card-lifecycle`,children:`Card Lifecycle`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Order Placed:`}),` `,_jsx(_components.code,{children:`POST /v1/card/order`}),` returns `,_jsx(_components.code,{children:`success: true`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Card Provisioning:`}),` Backend systems provision the virtual card`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Card Active:`}),` Card status becomes `,_jsx(_components.code,{children:`ACTIVE`}),` and is ready for transactions`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Card Usage:`}),` User can make purchases using the card`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`best-practices`,children:`Best Practices`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Always check user verification status before attempting to order a card`}),`\n`,_jsx(_components.li,{children:`Implement proper error handling for all possible error codes`}),`\n`,_jsxs(_components.li,{children:[`Poll `,_jsx(_components.code,{children:`GET /v1/card/status`}),` after ordering to confirm card activation`]}),`\n`,_jsx(_components.li,{children:`Inform users that only virtual cards are currently available`}),`\n`,_jsx(_components.li,{children:`Consider adding rate limiting to prevent duplicate card order attempts`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`security-considerations`,children:`Security Considerations`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Never log or store the complete card details in your application`}),`\n`,_jsx(_components.li,{children:`Use secure token-based endpoints for displaying sensitive card information`}),`\n`,_jsx(_components.li,{children:`Implement proper access controls to ensure users can only order cards for themselves`}),`\n`,_jsx(_components.li,{children:`Validate user authentication before allowing card operations`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`related-endpoints`,children:`Related Endpoints`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`GET /v1/card/status`}),` - Check card status and details`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`POST /v1/card/details/token`}),` - Generate token to view card details`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`POST /v1/card/set-pin/token`}),` - Generate token to set card PIN`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`POST /v1/card/freeze`}),` - Temporarily disable card`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`GET /v1/user/profile`}),` - Check user verification status`]}),`\n`]})]})}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":{"config":{},"pageMetadata":{"title":"Order a Card","api":"POST https://dev.api.baanx.com/v1/card/order","description":"Order a new card for the authenticated user","href":"/api-reference/card/order","hidden":false}}},"mdxSourceWithNoJs":null,"noJsSplices":[[389,393,"Example,ResponseFiel"],[840,855,"Example)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingM"],[27417,27436,"_jsx(ResponseExample,{children:_jsx(CodeBlock,{filename:`200 - Success`,numberOfLines:`3`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})}),`\n`,_jsx(Heading,{l"],[27499,34644,"_jsxs(ResponseExample,{children:[_jsx(CodeBlock,{filename:`400 - Bad Request`,numberOfLines:`3`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"User already has a card\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`401 - Unauthorized`,numberOfLines:`3`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Not authenticated\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`403 - Forbidden`,numberOfLines:`3`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Not authorized\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`422 - Validation Error`,numberOfLines:`3`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"type field is required\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`498 - Invalid Client Key`,numberOfLines:`3`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Invalid client key\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`499 - Missing Client Key`,numberOfLines:`3`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Missing client key\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`500 - Internal Server Error`,numberOfLines:`3`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Internal server error\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`common-error-scenarios`,children:`Common Error Scenarios`}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`User Not Verified`,id:`user-not-verified`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Error:`}),` `,_jsx(_components.code,{children:`400 Bad Request`})]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Cause:`}),` User has not completed KYC verification`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Solution:`}),` Complete user verification before ordering a card. Check user status with `,_jsx(_components.code,{children:`GET /v1/user/profile`})]})]}),_jsxs(Accordion,{title:`User Already Has Card`,id:`user-already-has-card`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Error:`}),` `,_jsx(_components.code,{children:`400 Bad Request`})]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Message:`}),` `,_jsx(_components.code,{children:`\"User already has a card\"`})]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Cause:`}),` User already has an existing card`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Solution:`}),` Use `,_jsx(_components.code,{children:`GET /v1/card/status`}),` to retrieve existing card details instead of ordering a new one`]})]}),_jsxs(Accordion,{title:`Invalid Card Type`,id:`invalid-card-type`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Error:`}),` `,_jsx(_components.code,{children:`422 Validation Error`})]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Cause:`}),` Invalid value provided for `,_jsx(_components.code,{children:`type`}),` field`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Solution:`}),` Ensure the `,_jsx(_components.code,{children:`type`}),` field is set to `,_jsx(_components.code,{children:`VIRTUAL`}),`. Physical cards are not yet supported.`]})]}),_jsxs(Accordion,{title:`Missing Authentication`,id:`missing-authentication`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Error:`}),` `,_jsx(_components.code,{children:`401 Unauthorized`})]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Cause:`}),` Missing or invalid Bearer token`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Solution:`}),` Ensure you include a valid access token in the Authorization header`]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next Steps`}),`\n`,_jsx(_components.p,{children:`After successfully ordering a card:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Check Card Status:`}),` Use `,_jsx(_components.code,{children:`GET /v1/card/status`}),` to monitor the card provisioning status`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`View Card Details:`}),` Once active, use `,_jsx(_components.code,{children:`POST /v1/card/details/token`}),` to generate a secure token for displaying sensitive card information`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Set PIN:`}),` Use `,_jsx(_components.code,{children:`POST /v1/card/set-pin/token`}),` to allow the user to set their card PIN`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Fund Card:`}),` In custodial environments, link a wallet to the card for funding transactions`]}),`\n`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`Card provisioning typically completes within a few seconds. The card status will change from `,_jsx(_components.code,{children:`PENDING`}),` to `,_jsx(_components.code,{children:`ACTIVE`}),` once ready for use.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`implementation-notes`,children:`Implementation Notes`}),`\n`,_jsx(Heading,{level:`3`,id:`card-lifecycle`,children:`Card Lifecycle`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Order Placed:`}),` `,_jsx(_components.code,{children:`POST /v1/card/order`}),` returns `,_jsx(_components.code,{children:`success: true`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Card Provisioning:`}),` Backend systems provision the virtual card`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Card Active:`}),` Card status becomes `,_jsx(_components.code,{children:`ACTIVE`}),` and is ready for transactions`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Card Usage:`}),` User can make purchases using the card`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`best-practices`,children:`Best Practices`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Always check user verification status before attempting to order a card`}),`\n`,_jsx(_components.li,{children:`Implement proper error handling for all possible error codes`}),`\n`,_jsxs(_components.li,{children:[`Poll `,_jsx(_components.code,{children:`GET /v1/card/status`}),` after ordering to confirm card activation`]}),`\n`,_jsx(_components.li,{children:`Inform users that only virtual cards are currently available`}),`\n`,_jsx(_components.li,{children:`Consider adding rate limiting to prevent duplicate card order attempts`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`security-considerations`,children:`Security Considerations`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Never log or store the complete card details in your application`}),`\n`,_jsx(_components.li,{children:`Use secure token-based endpoints for displaying sensitive card information`}),`\n`,_jsx(_components.li,{children:`Implement proper access controls to ensure users can only order cards for themselves`}),`\n`,_jsx(_components.li,{children:`Validate user authentication before allowing card operations`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`related-endpoints`,children:`Related Endpoints`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`GET /v1/card/status`}),` - Check card status and details`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`POST /v1/card/details/token`}),` - Generate token to view card details`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`POST /v1/card/set-pin/token`}),` - Generate token to set card PIN`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`POST /v1/card/freeze`}),` - Temporarily disable card`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`GET /v1/user/profile`}),` - Check user verification status`]}),`\n`]})]})}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.\")}"]]},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"Authentication","slug":"authentication","depth":2,"children":[]},{"title":"Request","slug":"request","depth":2,"children":[{"title":"Headers","slug":"headers","depth":3,"children":[]},{"title":"Body","slug":"body","depth":3,"children":[]},{"title":"Request Example","slug":"request-example","depth":3,"children":[]}]},{"title":"Response","slug":"response","depth":2,"children":[{"title":"Success Response","slug":"success-response","depth":3,"children":[]}]},{"title":"Error Responses","slug":"error-responses","depth":2,"children":[]},{"title":"Common Error Scenarios","slug":"common-error-scenarios","depth":2,"children":[]},{"title":"Next Steps","slug":"next-steps","depth":2,"children":[]},{"title":"Implementation Notes","slug":"implementation-notes","depth":2,"children":[{"title":"Card Lifecycle","slug":"card-lifecycle","depth":3,"children":[]},{"title":"Best Practices","slug":"best-practices","depth":3,"children":[]},{"title":"Security Considerations","slug":"security-considerations","depth":3,"children":[]}]},{"title":"Related Endpoints","slug":"related-endpoints","depth":2,"children":[]}],"codeExamples":{"response":{"type":"ResponseExample","children":[{"filename":"200 - Success","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"3\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"success\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Order a Card","path":"/v1/card/order","servers":[{"url":"https://dev.api.baanx.com"}],"method":"post","request":{"security":[],"parameters":{"query":{},"header":{"x-client-key":{"schema":[{"type":"string","description":"Your public API client key","required":true}]},"x-us-env":{"schema":[{"type":"boolean","description":"Set to `true` to route requests to the US backend environment"}]},"Authorization":{"schema":[{"type":"string","description":"Bearer token for authentication","required":true}]}},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"type":[{"type":"string","description":"The type of card to order. Currently only supports `VIRTUAL` Accepted Values: `VIRTUAL` - Digital card for online and mobile payments","required":true}]}}],"examples":{"example":{"value":{"type":"\u003cstring>"}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"success":[{"type":"boolean","description":"Indicates whether the card order was accepted successfully"}]}}],"examples":{"example":{"value":{"success":true}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"baanxgroup","siteName":"Baanx API","title":"Order a Card - Baanx API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2025-10-15T13:59:39.453Z","originalFileLocation":"api-reference/card/order.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=\"Order a new card for the authenticated user\">\u003cmeta data-mint-head name=\"application-name\" content=\"Baanx API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/baanxgroup/0noly4cKYD8qeZxA/_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/baanxgroup/0noly4cKYD8qeZxA/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/baanxgroup/0noly4cKYD8qeZxA/_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/baanxgroup/0noly4cKYD8qeZxA/_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/baanxgroup/0noly4cKYD8qeZxA/_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/baanxgroup/0noly4cKYD8qeZxA/_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/baanxgroup/0noly4cKYD8qeZxA/_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/baanxgroup/0noly4cKYD8qeZxA/_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/baanxgroup/0noly4cKYD8qeZxA/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Order a Card - Baanx API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Order a new card for the authenticated user\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Baanx API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.baanx.com/api-reference/card/order\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://baanxgroup.mintlify.site/_mintlify/api/og/v2?division=Card\u0026amp;title=Order+a+Card\u0026amp;description=Order+a+new+card+for+the+authenticated+user\u0026amp;theme=e5ed9adb1acc63d397db9eeb\u0026amp;signature=0052697f442ebb958187da0ea7ccf6f03b97010593222f2e6ea92a4e33366e00\">\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=\"Order a Card - Baanx API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Order a new card for the authenticated user\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://baanxgroup.mintlify.site/_mintlify/api/og/v2?division=Card\u0026amp;title=Order+a+Card\u0026amp;description=Order+a+new+card+for+the+authenticated+user\u0026amp;theme=e5ed9adb1acc63d397db9eeb\u0026amp;signature=0052697f442ebb958187da0ea7ccf6f03b97010593222f2e6ea92a4e33366e00\">\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/baanxgroup/0noly4cKYD8qeZxA/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Baanx API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0D9373\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.baanx.com/api-reference/card/order\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/card/order.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.baanx.com/#organization\",\"name\":\"Baanx API\",\"url\":\"https://docs.baanx.com\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.baanx.com#website\",\"name\":\"Baanx API\",\"url\":\"https://docs.baanx.com\",\"publisher\":{\"@id\":\"https://docs.baanx.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.baanx.com/api-reference/card/order#webpage\",\"url\":\"https://docs.baanx.com/api-reference/card/order\",\"name\":\"Order a Card\",\"description\":\"Order a new card for the authenticated user\",\"dateModified\":\"2025-10-15T13:59:39.453Z\",\"isPartOf\":{\"@id\":\"https://docs.baanx.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.baanx.com/api-reference/card/order#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.baanx.com/api-reference/card/order#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Baanx API\",\"item\":\"https://docs.baanx.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Order a Card\",\"item\":\"https://docs.baanx.com/api-reference/card/order\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.baanx.com/api-reference/card/order#apireference\",\"headline\":\"Order a Card\",\"name\":\"Order a Card\",\"description\":\"Order a new card for the authenticated user\",\"url\":\"https://docs.baanx.com/api-reference/card/order\",\"mainEntityOfPage\":{\"@id\":\"https://docs.baanx.com/api-reference/card/order#webpage\"},\"dateModified\":\"2025-10-15T13:59:39.453Z\",\"publisher\":{\"@id\":\"https://docs.baanx.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.baanx.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Baanx API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Baanx API","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/guides/introduction"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]},{"group":"Authentication","pages":[{"title":"Authenticate User","api":"POST https://dev.api.baanx.com/v1/auth/login","href":"/api-reference/auth/login"},{"title":"Send OTP Code","api":"POST https://dev.api.baanx.com/v1/auth/login/otp","href":"/api-reference/auth/login-otp"},{"title":"Logout User","api":"POST https://dev.api.baanx.com/v1/auth/logout","href":"/api-reference/auth/logout"},{"title":"Initiate OAuth Authorization","api":"GET https://dev.api.baanx.com/v1/auth/oauth/authorize/initiate","href":"/api-reference/auth/oauth-authorize-initiate"},{"title":"Generate Authorization Code","api":"POST https://dev.api.baanx.com/v1/auth/oauth/authorize","href":"/api-reference/auth/oauth-authorize"},{"title":"Exchange Code for Tokens","api":"POST https://dev.api.baanx.com/v1/auth/oauth/token","href":"/api-reference/auth/oauth-token"},{"title":"Revoke OAuth Authorization","api":"DELETE https://dev.api.baanx.com/v1/auth/oauth/revoke","href":"/api-reference/auth/oauth-revoke"},{"title":"Get Onboarding Details","api":"GET https://dev.api.baanx.com/v1/auth/register","href":"/api-reference/auth/register"},{"title":"Send Registration Email","api":"POST https://dev.api.baanx.com/v1/auth/register/email/send","href":"/api-reference/auth/register-email-send"},{"title":"Verify Email Code","api":"POST https://dev.api.baanx.com/v1/auth/register/email/verify","href":"/api-reference/auth/register-email-verify"},{"title":"Send Phone Verification SMS","api":"POST https://dev.api.baanx.com/v1/auth/register/phone/send","href":"/api-reference/auth/register-phone-send"},{"title":"Verify Phone Code","api":"POST https://dev.api.baanx.com/v1/auth/register/phone/verify","href":"/api-reference/auth/register-phone-verify"},{"title":"Update Personal Details","api":"POST https://dev.api.baanx.com/v1/auth/register/personal-details","href":"/api-reference/auth/register-personal-details"},{"title":"Update Physical Address","api":"POST https://dev.api.baanx.com/v1/auth/register/address","href":"/api-reference/auth/register-address"},{"title":"Update Mailing Address","api":"POST https://dev.api.baanx.com/v1/auth/register/mailing-address","href":"/api-reference/auth/register-mailing-address"},{"title":"Generate KYC Verification Session","api":"POST https://dev.api.baanx.com/v1/auth/register/verification","href":"/api-reference/auth/register-verification"},{"title":"Get Registration Settings","api":"GET https://dev.api.baanx.com/v1/auth/settings","href":"/api-reference/auth/settings"}]},{"group":"User","pages":[{"title":"Get User Details","api":"GET https://dev.api.baanx.com/v1/user","href":"/api-reference/user/get-user"},{"title":"Start User Verification","api":"GET https://dev.api.baanx.com/v1/user/verification","description":"Generates a verification session URL for identity verification","href":"/api-reference/user/verification"}]},{"group":"Card","pages":[{"title":"Order a Card","api":"POST https://dev.api.baanx.com/v1/card/order","href":"/api-reference/card/order"},{"title":"Get Card Status","api":"GET https://dev.api.baanx.com/v1/card/status","description":"Retrieve the current status and details of the authenticated user's card","href":"/api-reference/card/status"},{"title":"Freeze Card","api":"POST https://dev.api.baanx.com/v1/card/freeze","href":"/api-reference/card/freeze"},{"title":"Unfreeze Card","api":"POST https://dev.api.baanx.com/v1/card/unfreeze","href":"/api-reference/card/unfreeze"},{"title":"Get Card Transactions","api":"GET https://dev.api.baanx.com/v1/card/transactions","href":"/api-reference/card/transactions"},{"title":"Generate Transaction Statement","api":"GET https://dev.api.baanx.com/v1/card/transactions/statement","href":"/api-reference/card/transactions-statement"},{"title":"Generate PIN View Token","api":"POST https://dev.api.baanx.com/v1/card/pin/token","href":"/api-reference/card/pin-token"},{"title":"Generate PIN Set Token","api":"POST https://dev.api.baanx.com/v1/card/set-pin/token","href":"/api-reference/card/set-pin-token"},{"title":"Generate Card Details Token","api":"POST https://dev.api.baanx.com/v1/card/details/token","href":"/api-reference/card/details-token"}]},{"group":"Orders","pages":[{"title":"Get Available Products","api":"GET /v1/order/products/available","href":"/api-reference/order/enum-products"},{"title":"Create Order","api":"POST /v1/order","href":"/api-reference/order/create"},{"title":"Get Order Status","api":"GET /v1/order/{orderId}","href":"/api-reference/order/status"}]},{"group":"Wallet","pages":[{"title":"Get/Create Internal Wallets","api":"GET https://dev.api.baanx.com/v1/wallet/internal","href":"/api-reference/wallet/internal"},{"title":"List Card-Linked Wallets","api":"GET /v1/wallet/internal/card_linked","href":"/api-reference/wallet/internal-card-linked-get"},{"title":"Link Wallet to Card","api":"POST /v1/wallet/internal/card_linked","href":"/api-reference/wallet/internal-card-linked-post"},{"title":"Unlink Wallet from Card","api":"DELETE /v1/wallet/internal/card_linked","href":"/api-reference/wallet/internal-card-linked-delete"},{"title":"Update Linked Wallet Priority","api":"PUT https://dev.api.baanx.com/v1/wallet/internal/card_linked/priority","href":"/api-reference/wallet/internal-card-linked-priority"},{"title":"Withdraw from Internal Wallet","api":"POST https://dev.api.baanx.com/v1/wallet/internal/withdraw","href":"/api-reference/wallet/internal-withdraw"},{"title":"Get External Wallets","api":"GET https://dev.api.baanx.com/v1/wallet/external","href":"/api-reference/wallet/external"},{"title":"Get External Wallet Priority","api":"GET /v1/wallet/external/priority","href":"/api-reference/wallet/external-priority-get"},{"title":"Update External Wallet Priority","api":"PUT /v1/wallet/external/priority","href":"/api-reference/wallet/external-priority-put"},{"title":"Get Credit Wallet Balance","api":"GET https://dev.api.baanx.com/v1/wallet/credit","href":"/api-reference/wallet/credit"},{"title":"Withdraw from Credit Wallet","api":"POST https://dev.api.baanx.com/v1/wallet/credit/withdraw","href":"/api-reference/wallet/credit-withdraw"},{"title":"Estimate Credit Withdrawal Fees","api":"GET https://dev.api.baanx.com/v1/wallet/credit/withdraw-estimation","href":"/api-reference/wallet/credit-withdraw-estimation"},{"title":"Get Reward Wallet Balance","api":"GET https://dev.api.baanx.com/v1/wallet/reward","href":"/api-reference/wallet/reward"},{"title":"Withdraw from Reward Wallet","api":"POST https://dev.api.baanx.com/v1/wallet/reward/withdraw","href":"/api-reference/wallet/reward-withdraw"},{"title":"Estimate Reward Withdrawal Fees","api":"GET https://dev.api.baanx.com/v1/wallet/reward/withdraw-estimation","href":"/api-reference/wallet/reward-withdraw-estimation"},{"title":"Get Whitelisted Addresses","api":"GET /v1/wallet/whitelist","href":"/api-reference/wallet/whitelist-get"},{"title":"Add Addresses to Whitelist","api":"POST /v1/wallet/whitelist","href":"/api-reference/wallet/whitelist-post"},{"title":"Remove Addresses from Whitelist","api":"DELETE /v1/wallet/whitelist","href":"/api-reference/wallet/whitelist-delete"},{"title":"Get Wallet Transaction History","api":"GET https://dev.api.baanx.com/v1/wallet/history","href":"/api-reference/wallet/history"}]},{"group":"Delegation","pages":[{"title":"Get Delegation Token","api":"GET /v1/delegation/token","href":"/api-reference/delegation/get-token"},{"title":"Get Blockchain Configuration","api":"GET https://dev.api.baanx.com/v1/delegation/chain/config","href":"/api-reference/delegation/chain-config"},{"title":"Complete EVM Wallet Delegation","api":"POST https://dev.api.baanx.com/v1/delegation/evm/post-approval","href":"/api-reference/delegation/evm-post-approval"},{"title":"Complete Solana Wallet Delegation","api":"POST https://dev.api.baanx.com/v1/delegation/solana/post-approval","href":"/api-reference/delegation/solana-post-approval"}]},{"group":"Consent","pages":[{"title":"Create Onboarding Consent","api":"POST /v2/consent/onboarding","href":"/api-reference/consent/create-onboarding-consent"},{"title":"Get Consent Sets by Onboarding ID","api":"GET /v2/consent/onboarding/{onboardingId}","href":"/api-reference/consent/get-onboarding-consent"},{"title":"Link User to Consent Set","api":"PATCH /v2/consent/onboarding/{consentSetId}","href":"/api-reference/consent/link-user-to-consent"},{"title":"Get Consent Set by ID","api":"GET /v2/consent/consentSet/{consentSetId}","href":"/api-reference/consent/get-consent-set"},{"title":"Get User Consent Status","api":"GET /v2/consent/user/{userId}","href":"/api-reference/consent/get-user-consent"},{"title":"Get Consent Audit Trail","api":"GET /v2/consent/user/{userId}/audit","href":"/api-reference/consent/get-consent-audit"},{"title":"Revoke Consent","api":"DELETE /v2/consent/consentSet/{consentSetId}/consent/{consentId}","href":"/api-reference/consent/revoke-consent"}]},{"group":"Referral","pages":[{"title":"Get User Referral Code","api":"GET /v1/referral","href":"/api-reference/referral/get-referral-code"},{"title":"Validate Referral Code","api":"GET /v1/referral/{code}/validate","href":"/api-reference/referral/validate-referral-code"}]},{"group":"Webhooks","pages":[{"title":"List Webhook Endpoints","api":"GET /v1/webhooks","href":"/api-reference/webhooks/list-webhooks"},{"title":"Create Webhook Endpoint","api":"POST /v1/webhooks","href":"/api-reference/webhooks/create-webhook"},{"title":"Get Webhook Endpoint","api":"GET /v1/webhooks/{id}","href":"/api-reference/webhooks/get-webhook"},{"title":"Update Webhook Endpoint","api":"PUT /v1/webhooks/{id}","href":"/api-reference/webhooks/update-webhook"},{"title":"Delete Webhook Endpoint","api":"DELETE /v1/webhooks/{id}","href":"/api-reference/webhooks/delete-webhook"},{"title":"Rotate Webhook Signing Key","api":"POST /v1/webhooks/{id}/rotate-key","href":"/api-reference/webhooks/rotate-key"},{"title":"Get Webhook Delivery Logs","api":"GET /v1/webhooks/{id}/logs","href":"/api-reference/webhooks/webhook-logs"},{"title":"List Events","api":"GET /v1/webhooks/events","href":"/api-reference/webhooks/list-events"},{"title":"Get Event Status","api":"GET /v1/webhooks/events/{eventId}/status","href":"/api-reference/webhooks/event-status"},{"title":"Get Event Delivery Logs","api":"GET /v1/webhooks/events/{eventId}/logs","href":"/api-reference/webhooks/event-logs"},{"title":"Retry Event Delivery","api":"POST /v1/webhooks/events/{eventId}/retry","href":"/api-reference/webhooks/retry-event"}]}]}]},"basePath":"","title":"Order a Card - Baanx API","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","Page-C945cI-W.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js"]}