{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Sudo Developer Documentation","colors":{"primary":"#000","light":"#FFF","dark":"#737373"},"logo":{"light":"https://mintcdn.com/sudoafricainc/0rYEZ-verRngCGW6/images/333e137-small-sudo-black.png?fit=max\u0026auto=format\u0026n=0rYEZ-verRngCGW6\u0026q=85\u0026s=f1abf960ebbfc77f55d8421c9fdbfe16","dark":"https://mintcdn.com/sudoafricainc/0rYEZ-verRngCGW6/images/logo-white.svg?fit=max\u0026auto=format\u0026n=0rYEZ-verRngCGW6\u0026q=85\u0026s=90e01bf5d44d3867db97f52970f543ec"},"favicon":"https://mintcdn.com/sudoafricainc/0rYEZ-verRngCGW6/favicon.svg?fit=max\u0026auto=format\u0026n=0rYEZ-verRngCGW6\u0026q=85\u0026s=b913c1ed730c4061e789e41fe2862ed2","api":{"openapi":["openapi.json"],"mdx":{"auth":{"method":"bearer"},"server":["https://api.sandbox.sudo.cards"]}},"navbar":{"links":[{"href":"mailto:root@sudo.africa","label":"Support"}],"primary":{"type":"button","label":"Get API Key","href":"https://app.sudo.africa"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"sudoafricainc","hasAudioNarration":false,"actualSubdomain":"sudoafricainc","customDomains":["docs.sudo.africa"],"gitSource":{"type":"github","owner":"sudoafrica","repo":"developer-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ada1cb71cd014c88d98c536","collectionId":"3e34d7da-5153-46e7-9c5f-d145ff205d52","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ada1cb71cd014c88d98c536"},"feedback":{"edits":true},"entitlements":{},"buildId":"6ada1cb71cd014c88d98c536","clientVersion":"0.0.3966","searchFilterCounts":[{"language":"default","tag":"API Reference","count":60},{"language":"default","tag":"Guides","count":39},{"language":"default","tag":"Cards","count":16},{"language":"default","tag":"Webhooks","count":9},{"language":"default","tag":"Overview","count":8},{"language":"default","tag":"Accounts","count":8},{"language":"default","tag":"Getting Started","count":6},{"language":"default","tag":"Simulator (Sandbox Only)","count":6},{"language":"default","tag":"Card Programs","count":6},{"language":"default","tag":"Customers","count":6}]},"assistantConfig":{},"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":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"editor-agent-model-picker","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":"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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":".mdx-content :not(pre)>code{margin:0;padding:1px 3px;border-radius:4px}"}],"page":{"pagePath":"reference/order-cards","slug":"/reference/order-cards","pageMetadata":{"openapi":"openapi.json post /cards/order","title":"Order Cards","description":"Order Physical Cards","href":"/reference/order-cards"},"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 Physical Cards\"\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":{"openapi":"openapi.json post /cards/order","title":"Order Cards","description":"Order Physical Cards","href":"/reference/order-cards"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Order Cards","description":"Order Physical Cards","operationId":"order-cards","requestBody":"3ffa3726-3fdc-4064-b8e1-061fcc3cba5a","responses":{"201":"da110fa7-5512-42cc-b2a1-d0769155ac3a","400":"ea690ba8-e461-4730-a9f8-4676c2ef1387","401":"6e03c383-8a11-42b6-80a5-f067d832e96c"},"deprecated":false,"method":"post","type":"path","servers":["cf545e2d-d094-497e-b3d3-01d65265413d"],"security":["382c7c40-6f98-4695-a479-e95030640a06"],"path":"/cards/order","baseUrlOptions":["https://api.sandbox.sudo.cards"],"title":"Order Cards","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["debitAccountId","brand","currency","allocation","expedite","shippingMethod","shippingAddress"],"properties":{"debitAccountId":{"type":"string","description":"The debit account `_id`.","isRequired":true,"uniqueKey":"debitAccountId","typeLabel":"string"},"brand":{"type":"string","description":"The card brand.","enum":["Verve","AfriGo","MasterCard","Visa"],"isRequired":true,"uniqueKey":"brand","typeLabel":"enum\u003cstring>"},"currency":{"type":"string","description":"The currency type.","default":"NGN","enum":["NGN","USD"],"isRequired":true,"uniqueKey":"currency","typeLabel":"enum\u003cstring>"},"allocation":{"type":"integer","description":"The number of physical cards to order.","default":1,"format":"int32","isRequired":true,"uniqueKey":"allocation","typeLabel":"integer\u003cint32>"},"expedite":{"type":"boolean","description":"The expedite preference.","default":false,"isRequired":true,"uniqueKey":"expedite","typeLabel":"boolean"},"shippingMethod":{"type":"string","description":"The shipping method to use. Might impact card cost. Ask Customer Support for guidance.","default":"NIPOST","enum":["NIPOST","DHL"],"isRequired":true,"uniqueKey":"shippingMethod","typeLabel":"enum\u003cstring>"},"shippingAddress":{"type":"object","description":"The cards shipping address.","required":["line1","city","state","postalCode","country"],"properties":{"line1":{"type":"string","description":"Street address line 1","isRequired":true,"uniqueKey":"shippingAddress.line1","typeLabel":"string"},"city":{"type":"string","description":"City","isRequired":true,"uniqueKey":"shippingAddress.city","typeLabel":"string"},"state":{"type":"string","description":"State","isRequired":true,"uniqueKey":"shippingAddress.state","typeLabel":"string"},"postalCode":{"type":"string","isRequired":true,"uniqueKey":"shippingAddress.postalCode","typeLabel":"string"},"country":{"type":"string","description":"Billing country","isRequired":true,"uniqueKey":"shippingAddress.country","typeLabel":"string"},"line2":{"type":"string","description":"Street Address line 2","uniqueKey":"shippingAddress.line2","typeLabel":"string"}},"isRequired":true,"uniqueKey":"shippingAddress","typeLabel":"object"},"customerId":{"type":"string","description":"The customer `_id`. Required if creating 1 card","uniqueKey":"customerId","typeLabel":"string"},"design":{"type":"string","description":"The name of the card design. Ask Customer support for your own design name.","default":"SudoBlack","enum":["SudoBlack","SudoWhite","[YourDesignName]"],"uniqueKey":"design","typeLabel":"enum\u003cstring>"},"nameOnCards":{"type":"array","description":"Array of names to be personalized on the cards.","items":{"type":"string","uniqueKey":"nameOnCards.items.[INDEX]","typeLabel":"string"},"uniqueKey":"nameOnCards","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"debitAccountId":"\u003cstring>","currency":"NGN","allocation":1,"expedite":false,"shippingMethod":"NIPOST","shippingAddress":{"line1":"\u003cstring>","city":"\u003cstring>","state":"\u003cstring>","postalCode":"\u003cstring>","country":"\u003cstring>","line2":"\u003cstring>"},"customerId":"\u003cstring>","design":"SudoBlack","nameOnCards":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"da110fa7-5512-42cc-b2a1-d0769155ac3a":{"description":"Cards ordered successfully.","headers":{"X-Powered-By":{"schema":{"type":"string"},"example":"Express"},"Access-Control-Allow-Origin":{"schema":{"type":"string"},"example":"*"},"X-RateLimit-Limit":{"schema":{"type":"integer"},"example":"250000"},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"example":"249999"},"X-RateLimit-Reset":{"schema":{"type":"integer"},"example":"0"},"Content-Type":{"schema":{"type":"string"},"example":"application/json; charset=utf-8"},"ETag":{"schema":{"type":"string"},"example":"W/\"2dd-sfRBgLV2BqnKnzwqFCi2UGdBgUQ\""},"Connection":{"schema":{"type":"string"},"example":"keep-alive"},"Keep-Alive":{"schema":{"type":"string"},"example":"timeout=5"}},"content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","description":"HTTP status code returned by the API.","uniqueKey":"statusCode","typeLabel":"integer"},"message":{"type":"string","description":"Human-readable description of the result.","uniqueKey":"message","typeLabel":"string"},"data":{"type":"object","description":"Response payload.","properties":{"batchReference":{"type":"string","description":"Reference for the card order batch.","uniqueKey":"data.batchReference","typeLabel":"string"},"allocation":{"type":"integer","description":"Number of cards in the order.","uniqueKey":"data.allocation","typeLabel":"integer"},"brand":{"type":"string","description":"Card scheme/brand (e.g. `Verve`, `MasterCard`).","uniqueKey":"data.brand","typeLabel":"string"},"status":{"type":"string","description":"Current status of the object.","uniqueKey":"data.status","typeLabel":"string"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"statusCode":200,"message":"Cards ordered successfully.","data":{"batchReference":"ORD-250604-2156","allocation":5,"brand":"Verve","status":"processing"}},"examples":{"Example":{"title":"Example","value":{"statusCode":200,"message":"Cards ordered successfully.","data":{"batchReference":"ORD-250604-2156","allocation":5,"brand":"Verve","status":"processing"}}}},"exampleType":"examples"}},"exampleType":"examples"},"ea690ba8-e461-4730-a9f8-4676c2ef1387":{"description":"Validation error.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code for the failed request.","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"message":{"type":"string","description":"Human-readable description of the error.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"data":{"type":"null","description":"No response payload is returned for an error.","uniqueKey":"data","typeLabel":"null"}},"uniqueKey":"","typeLabel":"object"},"example":{"statusCode":400,"message":"\"customerId\" is required","data":null},"examples":{"Example":{"title":"Example","value":{"statusCode":400,"message":"\"customerId\" is required","data":null}}},"exampleType":"examples"}},"exampleType":"examples"},"6e03c383-8a11-42b6-80a5-f067d832e96c":{"description":"Authentication failed — missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code for the failed request.","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"message":{"type":"string","description":"Human-readable description of the error.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"data":{"type":"null","description":"No response payload is returned for an error.","uniqueKey":"data","typeLabel":"null"}},"uniqueKey":"","typeLabel":"object"},"example":{"statusCode":401,"message":"Unauthorized. Provide a valid API key in the Authorization header.","data":null},"examples":{"Example":{"title":"Example","value":{"statusCode":401,"message":"Unauthorized. Provide a valid API key in the Authorization header.","data":null}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"382c7c40-6f98-4695-a479-e95030640a06":{"sec0":{"type":"apiKey","in":"header","name":"Authorization","x-bearer-format":"bearer","x-default":"{{APIKey}}","scopes":[],"schemeName":"sec0"}}},"servers":{"cf545e2d-d094-497e-b3d3-01d65265413d":{"url":"https://api.sandbox.sudo.cards","description":"Sandbox"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Authorization","x-bearer-format":"bearer","x-default":"{{APIKey}}","scopes":[],"schemeName":"sec0"},"schema":{"title":"Authorization","type":"string","isRequired":true,"default":"{{APIKey}}","typeLabel":"string","deprecated":false},"schemeName":"sec0","name":"Authorization"}],"title":"sec0"}]},"originalFileLocation":"openapi.json"},"subdomain":"sudoafricainc","siteName":"Sudo Developer Documentation","title":"Order Cards - Sudo Developer Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2025-09-25T20:39:43.655Z","originalFileLocation":"reference/order-cards.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 Physical Cards\">\u003cmeta data-mint-head name=\"application-name\" content=\"Sudo Developer Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sudoafricainc/oq71R5vBAPrTjBZS/_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/sudoafricainc/oq71R5vBAPrTjBZS/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sudoafricainc/oq71R5vBAPrTjBZS/_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/sudoafricainc/oq71R5vBAPrTjBZS/_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/sudoafricainc/oq71R5vBAPrTjBZS/_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/sudoafricainc/oq71R5vBAPrTjBZS/_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/sudoafricainc/oq71R5vBAPrTjBZS/_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/sudoafricainc/oq71R5vBAPrTjBZS/_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/sudoafricainc/oq71R5vBAPrTjBZS/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Order Cards - Sudo Developer Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Order Physical Cards\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Sudo Developer Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.sudo.africa/reference/order-cards\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://sudoafricainc.mintlify.app/_mintlify/api/og/v2?division=Cards\u0026amp;title=Order+Cards\u0026amp;description=Order+Physical+Cards\u0026amp;theme=41b0407a45f05dc9293b858a\u0026amp;signature=833ce812a29528d6495eaa8dc701cb25d648a455ab59015f2e8dac2dbfb5bd9a\">\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 Cards - Sudo Developer Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Order Physical Cards\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sudoafricainc.mintlify.app/_mintlify/api/og/v2?division=Cards\u0026amp;title=Order+Cards\u0026amp;description=Order+Physical+Cards\u0026amp;theme=41b0407a45f05dc9293b858a\u0026amp;signature=833ce812a29528d6495eaa8dc701cb25d648a455ab59015f2e8dac2dbfb5bd9a\">\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/sudoafricainc/oq71R5vBAPrTjBZS/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Sudo Developer Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.sudo.africa/reference/order-cards\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/order-cards.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.sudo.africa/#organization\",\"name\":\"Sudo Developer Documentation\",\"url\":\"https://docs.sudo.africa\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/sudoafricainc/0rYEZ-verRngCGW6/images/333e137-small-sudo-black.png?fit=max\u0026auto=format\u0026n=0rYEZ-verRngCGW6\u0026q=85\u0026s=f1abf960ebbfc77f55d8421c9fdbfe16\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.sudo.africa#website\",\"name\":\"Sudo Developer Documentation\",\"url\":\"https://docs.sudo.africa\",\"publisher\":{\"@id\":\"https://docs.sudo.africa/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.sudo.africa/reference/order-cards#webpage\",\"url\":\"https://docs.sudo.africa/reference/order-cards\",\"name\":\"Order Cards\",\"description\":\"Order Physical Cards\",\"dateModified\":\"2025-09-25T20:39:43.655Z\",\"isPartOf\":{\"@id\":\"https://docs.sudo.africa#website\"},\"breadcrumb\":{\"@id\":\"https://docs.sudo.africa/reference/order-cards#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.sudo.africa/reference/order-cards#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Cards\",\"item\":\"https://docs.sudo.africa/reference/cards\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Order Cards\",\"item\":\"https://docs.sudo.africa/reference/order-cards\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.sudo.africa/reference/order-cards#apireference\",\"headline\":\"Order Cards\",\"name\":\"Order Cards\",\"description\":\"Order Physical Cards\",\"url\":\"https://docs.sudo.africa/reference/order-cards\",\"mainEntityOfPage\":{\"@id\":\"https://docs.sudo.africa/reference/order-cards#webpage\"},\"dateModified\":\"2025-09-25T20:39:43.655Z\",\"publisher\":{\"@id\":\"https://docs.sudo.africa/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.sudo.africa#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Sudo Developer Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Sudo Developer Documentation","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/docs/getting-started"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"Introduction","href":"/reference/introduction"}]},{"group":"Customers","pages":[{"title":"Overview","href":"/reference/customers"},{"openapi":"openapi.json post /customers","title":"Create Customer","href":"/reference/create-customer"},{"openapi":"openapi.json get /customers","title":"Get Customers","href":"/reference/get-customers"},{"openapi":"openapi.json get /customers/{id}","title":"Get Customer","href":"/reference/get-customer"},{"openapi":"openapi.json put /customers/{id}","title":"Update Customer","href":"/reference/update-customer"},{"openapi":"openapi.json put /customers/{id}/documents/url","title":"Generate Customer Document URL","href":"/reference/generate-customer-document-url"}]},{"group":"Funding Sources","pages":[{"title":"Overview","href":"/reference/funding-sources"},{"openapi":"openapi.json post /fundingsources","title":"Create Funding Source","href":"/reference/create-funding-source"},{"openapi":"openapi.json get /fundingsources","title":"Get Funding Sources","href":"/reference/get-funding-sources"},{"openapi":"openapi.json get /fundingsources/{id}","title":"Get Funding Source","href":"/reference/get-funding-source"},{"openapi":"openapi.json put /fundingsources/{id}","title":"Update Funding Source","href":"/reference/update-funding-source"}]},{"group":"Card Programs","pages":[{"title":"Overview","href":"/reference/card-programs"},{"openapi":"openapi.json post /card-programs","title":"Create Card Program","href":"/reference/create-card-program"},{"openapi":"openapi.json get /card-programs","title":"Get Card Programs","href":"/reference/get-card-programs"},{"openapi":"openapi.json get /card-programs/{id}","title":"Get a Card Program","href":"/reference/get-card-program"},{"openapi":"openapi.json get /card-programs/{id}/cards","title":"Get Cards By a Program","href":"/reference/get-card-program-cards"},{"openapi":"openapi.json patch /card-programs/{id}","title":"Update a Card Program","href":"/reference/update-card-program"}]},{"group":"Cards","pages":[{"title":"Overview","href":"/reference/cards"},{"openapi":"openapi.json post /cards","title":"Create Card","href":"/reference/create-card"},{"openapi":"openapi.json get /cards","title":"Get Cards","href":"/reference/get-cards"},{"openapi":"openapi.json get /cards/customer/{id}","title":"Get Customer Cards","href":"/reference/get-customer-cards"},{"openapi":"openapi.json get /cards/{id}","title":"Get Card","href":"/reference/get-card"},{"openapi":"openapi.json get /cards/{id}/balance","title":"Get Card Balance","href":"/reference/get-card-balance"},{"openapi":"openapi.json put /cards/{id}/send-pin","title":"Send Default Card PIN","href":"/reference/send-default-card-pin"},{"openapi":"openapi.json put /cards/{id}/pin","title":"Change Card PIN","href":"/reference/change-card-pin"},{"openapi":"openapi.json put /cards/{id}/enroll2fa","title":"Enroll Card for 2FA","href":"/reference/enroll-card-for-2fa"},{"openapi":"openapi.json put /cards/{id}","title":"Update Card","href":"/reference/update-card"},{"openapi":"openapi.json get /cards/{id}/token","title":"Generate Card Token","href":"/reference/generate-card-token"},{"openapi":"openapi.json put /cards/digitalize/{id}","title":"Digitalize Card","description":"Fetches required payload for Card Digitalization SDK for a specific card.","href":"/reference/card-digitalization"},{"openapi":"openapi.json post /cards/order","title":"Order Cards","href":"/reference/order-cards"}]},{"group":"Accounts","pages":[{"title":"Overview","description":"Use the Accounts API to create accounts, check balances, and move funds.","href":"/reference/accounts"},{"openapi":"openapi.json post /accounts","title":"Create Account","href":"/reference/create-account"},{"openapi":"openapi.json get /accounts","title":"Get Accounts","href":"/reference/get-accounts"},{"openapi":"openapi.json get /accounts/{id}","title":"Get Account","href":"/reference/get-account"},{"openapi":"openapi.json get /accounts/{id}/balance","title":"Get Account Balance","href":"/reference/get-account-balance"},{"openapi":"openapi.json get /accounts/{id}/transactions","title":"Get Account Transactions","href":"/reference/get-account-transactions"},{"openapi":"openapi.json post /accounts/transfer","title":"Fund Transfer","href":"/reference/fund-transfer"},{"openapi":"openapi.json get /accounts/transfer/rate/{currencyPair}","title":"Transfer Rate","href":"/reference/transfer-rate"}]},{"group":"Authorizations","pages":[{"title":"Overview","href":"/reference/authorizations"},{"openapi":"openapi.json get /cards/authorizations","title":"Get Authorizations","href":"/reference/get-authorizations"},{"openapi":"openapi.json get /cards/{id}/authorizations","title":"Get Card Authorizations","href":"/reference/get-card-authorizations"},{"openapi":"openapi.json get /cards/authorizations/{id}","title":"Get Authorization","href":"/reference/get-authorization"},{"openapi":"openapi.json put /cards/authorizations/{id}","title":"Update Authorization","href":"/reference/update-authorization"}]},{"group":"Transactions","pages":[{"title":"Overview","href":"/reference/transactions"},{"openapi":"openapi.json get /cards/transactions","title":"Get Transactions","href":"/reference/get-transactions"},{"openapi":"openapi.json get /cards/{id}/transactions","title":"Get Card Transactions","href":"/reference/get-card-transactions"},{"openapi":"openapi.json get /cards/transactions/{id}","title":"Get Transaction","href":"/reference/get-transaction"},{"openapi":"openapi.json put /cards/transactions/{id}","title":"Update Transaction","href":"/reference/update-transaction"}]},{"group":"Disputes","pages":[{"title":"Overview","href":"/reference/disputes"},{"openapi":"openapi.json post /cards/disputes","title":"Create Dispute","href":"/reference/create-dispute"},{"openapi":"openapi.json get /cards/disputes","title":"Get Disputes","href":"/reference/get-disputes"},{"openapi":"openapi.json get /cards/disputes/{id}","title":"Get Dispute","href":"/reference/get-dispute"},{"openapi":"openapi.json put /cards/disputes/{id}","title":"Update Dispute","href":"/reference/update-dispute"}]},{"group":"Simulator (Sandbox Only)","pages":[{"title":"Overview","href":"/reference/simulators"},{"openapi":"openapi.json post /accounts/simulator/fund","title":"Fund Account","href":"/reference/fund-account"},{"openapi":"openapi.json get /cards/simulator/generate","title":"Generate Test Physical Card","href":"/reference/generate-test-card"},{"openapi":"openapi.json post /cards/simulator/balance_enqiry","title":"Balance Enquiry","href":"/reference/balance-enquiry"},{"openapi":"openapi.json post /cards/simulator/authorization","title":"Simulate Authorization","href":"/reference/simulate-authorization"},{"openapi":"openapi.json get /cards/simulator/authorization/{id}/reversal","title":"Simulate Authorization Reversal","href":"/reference/simulate-authorization-reversal"}]}]}]},"title":"Order Cards - Sudo Developer Documentation","buildId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","deploymentId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DKJwRUt2.js","utils-CWD_VS3u.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-oFjciODD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C76WsxC3.js","snippetPresets-DvPMxpX_.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CuNQfndH.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BVFpVUoF.js","shallow-t59Jg5Kr.js","getApiPlaygroundDisplay-C_JZ4amX.js","CodeSnippet-CLRDnx_h.js","CodeSnippets-C2myU4kc.js","Page-7TwLLapg.js","getPastedJson-B-JaVXw7.js","icon-BA-iDhH3.js","MethodPill-D4qZABFp.js","DuplicateIcon-THIDKO1O.js","createIcon-CYYJwgFd.js","DynamicMarkdown-UGQuxDKp.js","SectionHeading-jYELb23h.js","axios-vUo_bRtp.js","Markdown-DKsLa3wy.js","clsx-CefdjKz2.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BaREnp3o.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-sgx_0XzF.js"]}