Identify each printing device, and see which credential each endpoint needs.
Each device (phone, POS, PC) that prints vouchers is a terminal linked to the shop. A terminal is identified by an API key that you generate once per device (for example a UUID), store on the device, and register with Register / check the terminal.The voucher and session calls identify the terminal through an HTTP header:
api-key: <your terminal API key>
Keep the key secret: anyone with it can print vouchers on the shop’s balance.
For reprint, duplicate and confirm-reprint, either credential is enough. The device can call them with its API key and no login, and the shop owner can call them from a back office with a login and no API key. Any other caller gets 403 access_denied.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"TuniMobile Integration API","description":"Sell TuniMobile recharge vouchers (Tunisie Telecom, Orange, Ooredoo) from your own application.","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"favicon":"https://mintcdn.com/tuni-mobile/Z828WuxAtlYeXtz_/favicon.svg?fit=max\u0026auto=format\u0026n=Z828WuxAtlYeXtz_\u0026q=85\u0026s=751b3784f11581568ccef74e925f1179","api":{"playground":{"display":"none"},"mdx":{"server":["https://apitest.tunimobile.com/v1","https://api.tunimobile.com/v1"]}},"navbar":{"primary":{"type":"button","label":"TuniMobile","href":"https://tunimobile.com"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tuni-mobile","hasAudioNarration":false,"actualSubdomain":"tuni-mobile","customDomains":["docs.tunimobile.com"],"gitSource":{"type":"artifacts","owner":"prod","repo":"6ae21fe4ea96bbaeeb8784af","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6ae21ffba70829123067bb16"},"chroma":{"latestBuiltDeploymentHistoryId":"6ae22000a70829123067bb6d","collectionId":"05866f62-ca31-443e-b395-f9b61dfd0860","liveDeploymentHistoryId":"6ae22000a70829123067bb6d","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae2394a0ef2a112dc97d4d0","clientVersion":"0.0.4005","searchFilterCounts":[{"language":"default","tag":"Getting Started","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"basics/terminal-api-key","slug":"/basics/terminal-api-key","pageMetadata":{"title":"Terminal API key","description":"Identify each printing device, and see which credential each endpoint needs.","icon":"mobile","href":"/basics/terminal-api-key"},"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: \"Identify each printing device, and see which credential each endpoint needs.\"\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={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Each device (phone, POS, PC) that prints vouchers is a `,_jsx(_components.strong,{children:`terminal`}),` linked to the shop. A terminal is identified by an API key that `,_jsx(_components.strong,{children:`you generate`}),` once per device (for example a UUID), store on the device, and register with `,_jsx(_components.a,{href:`/api/terminal/register`,children:`Register / check the terminal`}),`.`]}),`\n`,_jsx(_components.p,{children:`The voucher and session calls identify the terminal through an HTTP header:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`http`,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:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`api-key`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \u003cyour terminal API key>`})]}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Keep the key secret: anyone with it can print vouchers on the shop’s balance.`})}),`\n`,_jsx(Heading,{level:`2`,id:`who-can-call-what`,children:`Who can call what`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Endpoint`}),_jsx(_components.th,{children:`Login (cookie / Bearer)`}),_jsxs(_components.th,{children:[`Terminal `,_jsx(_components.code,{children:`api-key`}),` header`]})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.a,{href:`/api/auth/login`,children:`Log in`}),`, `,_jsx(_components.a,{href:`/api/auth/refresh`,children:`Refresh`})]}),_jsx(_components.td,{children:`not needed`}),_jsx(_components.td,{children:`not needed`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.a,{href:`/api/account/profile`,children:`Profile`}),`, `,_jsx(_components.a,{href:`/api/account/balance`,children:`Balance`}),`, `,_jsx(_components.a,{href:`/api/terminal/register`,children:`Register terminal`}),`, `,_jsx(_components.a,{href:`/api/vouchers/history`,children:`Voucher history`}),`, `,_jsx(_components.a,{href:`/api/auth/logout`,children:`Log out`})]}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`required`})}),_jsx(_components.td,{children:`not needed`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.a,{href:`/api/vouchers/generate`,children:_jsx(_components.code,{children:`printVoucher`})}),`, `,_jsx(_components.a,{href:`/api/vouchers/confirm`,children:_jsx(_components.code,{children:`confirmVoucher`})})]}),_jsx(_components.td,{children:`not needed`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`required`})})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.a,{href:`/api/vouchers/reprint`,children:_jsx(_components.code,{children:`reprintVoucher`})}),`, `,_jsx(_components.a,{href:`/api/vouchers/duplicate`,children:_jsx(_components.code,{children:`duplicateVoucher`})}),`, `,_jsx(_components.a,{href:`/api/vouchers/confirm-reprint`,children:_jsx(_components.code,{children:`confirmReprintVoucher`})})]}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`either`}),` login as the shop owner `,_jsx(_components.strong,{children:`or`}),` the API key of the terminal that printed the voucher`]}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.a,{href:`/api/sessions/rotate`,children:`Open / close session`})}),_jsx(_components.td,{children:`not needed`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`required`})})]})]})]}),`\n`,_jsxs(_components.p,{children:[`For reprint, duplicate and confirm-reprint, either credential is enough. The device can call them with its API key and no login, and the shop owner can call them from a back office with a login and no API key. Any other caller gets `,_jsx(_components.code,{children:`403 access_denied`}),`.`]})]})}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":"Terminal API key","description":"Identify each printing device, and see which credential each endpoint needs.","icon":"mobile","href":"/basics/terminal-api-key"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Who can call what","slug":"who-can-call-what","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"tuni-mobile","siteName":"TuniMobile Integration API","title":"Terminal API key - TuniMobile Integration API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-28T18:05:07.031Z","originalFileLocation":"basics/terminal-api-key.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=\"Identify each printing device, and see which credential each endpoint needs.\">\u003cmeta data-mint-head name=\"application-name\" content=\"TuniMobile Integration 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/tuni-mobile/hk79GHUBoQsFCvCv/_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/tuni-mobile/hk79GHUBoQsFCvCv/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tuni-mobile/hk79GHUBoQsFCvCv/_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/tuni-mobile/hk79GHUBoQsFCvCv/_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/tuni-mobile/hk79GHUBoQsFCvCv/_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/tuni-mobile/hk79GHUBoQsFCvCv/_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/tuni-mobile/hk79GHUBoQsFCvCv/_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/tuni-mobile/hk79GHUBoQsFCvCv/_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/tuni-mobile/hk79GHUBoQsFCvCv/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Terminal API key - TuniMobile Integration API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Identify each printing device, and see which credential each endpoint needs.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"TuniMobile Integration API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.tunimobile.com/basics/terminal-api-key\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tuni-mobile.mintlify.app/_mintlify/api/og/v2?division=Basics\u0026amp;title=Terminal+API+key\u0026amp;description=Identify+each+printing+device%2C+and+see+which+credential+each+endpoint+needs.\u0026amp;theme=df44427d4ddbca4dea795833\u0026amp;signature=9baec6e829157173fcfc1b5cf266f6879c6a82bee4d417d46921069a2ed91aae\">\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=\"Terminal API key - TuniMobile Integration API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Identify each printing device, and see which credential each endpoint needs.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tuni-mobile.mintlify.app/_mintlify/api/og/v2?division=Basics\u0026amp;title=Terminal+API+key\u0026amp;description=Identify+each+printing+device%2C+and+see+which+credential+each+endpoint+needs.\u0026amp;theme=df44427d4ddbca4dea795833\u0026amp;signature=9baec6e829157173fcfc1b5cf266f6879c6a82bee4d417d46921069a2ed91aae\">\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/tuni-mobile/hk79GHUBoQsFCvCv/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"TuniMobile Integration API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.tunimobile.com/basics/terminal-api-key\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/basics/terminal-api-key.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.tunimobile.com/#organization\",\"name\":\"TuniMobile Integration API\",\"url\":\"https://docs.tunimobile.com\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.tunimobile.com#website\",\"name\":\"TuniMobile Integration API\",\"url\":\"https://docs.tunimobile.com\",\"publisher\":{\"@id\":\"https://docs.tunimobile.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.tunimobile.com/basics/terminal-api-key#webpage\",\"url\":\"https://docs.tunimobile.com/basics/terminal-api-key\",\"name\":\"Terminal API key\",\"description\":\"Identify each printing device, and see which credential each endpoint needs.\",\"dateModified\":\"2026-10-28T18:05:07.031Z\",\"isPartOf\":{\"@id\":\"https://docs.tunimobile.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.tunimobile.com/basics/terminal-api-key#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.tunimobile.com/basics/terminal-api-key#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Basics\",\"item\":\"https://docs.tunimobile.com/basics/requests-and-responses\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Terminal API key\",\"item\":\"https://docs.tunimobile.com/basics/terminal-api-key\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.tunimobile.com/basics/terminal-api-key#article\",\"headline\":\"Terminal API key\",\"name\":\"Terminal API key\",\"description\":\"Identify each printing device, and see which credential each endpoint needs.\",\"url\":\"https://docs.tunimobile.com/basics/terminal-api-key\",\"mainEntityOfPage\":{\"@id\":\"https://docs.tunimobile.com/basics/terminal-api-key#webpage\"},\"dateModified\":\"2026-10-28T18:05:07.031Z\",\"publisher\":{\"@id\":\"https://docs.tunimobile.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.tunimobile.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"TuniMobile Integration API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"TuniMobile Integration API","nav":{"global":null,"pages":[{"group":"Getting Started","pages":[{"title":"Introduction","icon":"house","href":"/index"},{"title":"Quickstart","icon":"rocket","href":"/quickstart"}]},{"group":"Basics","pages":[{"title":"Requests and responses","icon":"arrow-right-arrow-left","href":"/basics/requests-and-responses"},{"title":"Authentication","description":"JWT access and refresh tokens delivered as cookies.","icon":"key","href":"/basics/authentication"},{"title":"Terminal API key","icon":"mobile","href":"/basics/terminal-api-key"}]},{"group":"Authentication","pages":[{"title":"Log in","description":"Log the user in and set the BEARER and refresh_token cookies.","api":"POST /login_check","href":"/api/auth/login"},{"title":"Refresh the session","api":"POST /token/refresh","href":"/api/auth/refresh"},{"title":"Log out","api":"GET /user/logout","href":"/api/auth/logout"}]},{"group":"Account","pages":[{"title":"Get the profile","api":"POST /user/do_action","href":"/api/account/profile"},{"title":"Get the balance","api":"POST /user/do_action","href":"/api/account/balance"}]},{"group":"Terminal","pages":[{"title":"Register / check the terminal","api":"POST /terminal/do_action","href":"/api/terminal/register"}]},{"group":"Vouchers","pages":[{"title":"Generate a voucher","sidebarTitle":"Generate (printVoucher)","api":"POST /voucher/do_action","href":"/api/vouchers/generate"},{"title":"Confirm a printed voucher","sidebarTitle":"Confirm (confirmVoucher)","api":"POST /voucher/do_action","href":"/api/vouchers/confirm"},{"title":"Reprint an unconfirmed voucher","sidebarTitle":"Reprint (reprintVoucher)","api":"POST /voucher/do_action","href":"/api/vouchers/reprint"},{"title":"Print a duplicate of a confirmed voucher","sidebarTitle":"Duplicate (duplicateVoucher)","api":"POST /voucher/do_action","href":"/api/vouchers/duplicate"},{"title":"Confirm a reprint or duplicate","sidebarTitle":"Confirm reprint (confirmReprintVoucher)","api":"POST /voucher/do_action","href":"/api/vouchers/confirm-reprint"},{"title":"List the voucher history","sidebarTitle":"History","api":"POST /vouchers","href":"/api/vouchers/history"}]},{"group":"Sales sessions","pages":[{"title":"Open / close a sales session","sidebarTitle":"Close and open session","api":"POST /session/","href":"/api/sessions/rotate"}]},{"group":"Reference","pages":[{"title":"Voucher statuses","icon":"list-check","href":"/reference/voucher-statuses"},{"title":"Errors","icon":"triangle-exclamation","href":"/reference/errors"}]}]},"title":"Terminal API key - TuniMobile Integration API","buildId":"dpl_48qhjNLiu9iJQQSZJz9Fa2ihBbPH","deploymentId":"dpl_48qhjNLiu9iJQQSZJz9Fa2ihBbPH","dynamics":[],"chunks":[]}