Show a cardholder their card number, expiry, and CVV without that data touching your servers or Dakota’s
Cards is available in sandbox only while we finish development. Dakota enables Cards per
account. The Cards endpoints are in the API reference, marked
Sandbox only. Endpoints, fields, and flows can still change before release.
No Dakota endpoint or webhook returns the full card number (PAN), expiry, or CVV. The most any card object carries is last4. To show the details, your backend mints a short-lived reveal session, and Cards.js uses it to render the values in the cardholder’s browser, inside a frame served by the card-data processor. The values never pass through your backend or Dakota’s.
origin is the HTTPS origin of the page that shows the card: scheme, host, and a port if it is not the default, with no path. A trailing / counts as a path and returns 400. The session only works on that origin. Plain http://localhost is rejected, including in development.
Cards.js sends sessionType and expects expiresAt. Your backend renames sessionType to session_type on the request to Dakota, and expires_at to expiresAt on the response it returns to Cards.js.
Do not send an X-Idempotency-Key. Every call mints a new session, including a retry.
Use the host that matches the environment you give Cards.js.
Rules to design around:
One session per reveal. A session works once. To show the details again, mint a new one.
Short-lived. A session expires 5 minutes after it is minted.
The card must be active. A pending, frozen, overdrawn, or closed card cannot mint a session. A closed card is refused with 403 card-closed. Check the card’s status before you mint: today Dakota refuses a pending, frozen or overdrawn card with a 5xx, not a 4xx, so the response alone does not tell you why.
Rate limited. Any of your API keys can mint sessions, up to 60 per minute and 600 per hour for your account. Over that, the call returns 429.
Your backend is the access check. Dakota verifies that the card belongs to your account, but it cannot know which of your users is asking. Authenticate the user and confirm they own the card before every mint. Without that check, any signed-in user could reveal any of your cards.
Show it with Cards.js
Cards.js (@dakota-xyz/cards-js) renders a masked card, mints a session through your backend when the user asks, reveals the values, and masks them again when the session window ends. It has React bindings.
Network & CSP: the frame origins your content security policy must allow
Showing card details needs a browser application. A Dakota-hosted reveal page for integrations without a frontend is planned.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Dakota","colors":{"primary":"#8e4410","light":"#a36336","dark":"#72360d"},"logo":{"light":"https://mintcdn.com/dakota-49818541/-tkRmX-DtPxqfDgt/images/dakota-logo-black.png?fit=max\u0026auto=format\u0026n=-tkRmX-DtPxqfDgt\u0026q=85\u0026s=c409f7b8cec2e984bd0c79735f637bfe","dark":"https://mintcdn.com/dakota-49818541/-tkRmX-DtPxqfDgt/images/dakota-logo-white.png?fit=max\u0026auto=format\u0026n=-tkRmX-DtPxqfDgt\u0026q=85\u0026s=9e77213d983822ac9d3e6cb211500b1f"},"favicon":"https://mintcdn.com/dakota-49818541/-tkRmX-DtPxqfDgt/favicon.png?fit=max\u0026auto=format\u0026n=-tkRmX-DtPxqfDgt\u0026q=85\u0026s=a998c62579c0a092af10b861d4c26197","api":{"openapi":"openapi.yaml","params":{"expanded":"closed"},"playground":{"display":"simple","proxy":false},"examples":{"languages":["curl","javascript","python","go"]}},"appearance":{"default":"dark"},"navbar":{"links":[{"href":"https://platform.dakota.xyz/signin","label":"Login"}],"primary":{"type":"button","label":"Get Started","href":"https://dakota.xyz/talk-to-sales"}},"footer":{"socials":{"x":"https://x.com/mintlify","github":"https://github.com/mintlify","linkedin":"https://linkedin.com/company/mintlify"}},"search":{"prompt":"Search or ask..."},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Support","icon":"headset","href":"https://support.dakota.xyz"},{"anchor":"Contact us","icon":"envelope","href":"https://dakota.xyz/talk-to-sales"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"dakota-49818541","hasAudioNarration":false,"actualSubdomain":"dakota-49818541","customDomains":["docs.dakota.xyz"],"gitSource":{"type":"github","owner":"dakota-xyz","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"documentation","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b006440baa97067db115bcf","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API reference","count":200},{"language":"default","tag":"Documentation","count":80},{"language":"default","tag":"Cards","count":42},{"language":"default","tag":"Agentic Payments","count":32},{"language":"default","tag":"Onboarding","count":26},{"language":"default","tag":"Authentication","count":13},{"language":"default","tag":"Signer Groups","count":13},{"language":"default","tag":"Customers","count":11},{"language":"default","tag":"Policies","count":10},{"language":"default","tag":"RD Marketing Fee","count":9}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"global.css","content":"[data-callout=\"note\"]{--callout-bg: #291f14 !important;--callout-border: #523e27 !important;--callout-icon: #9c8873 !important;background:#291f14!important;border-color:#523e27!important}[data-callout=\"note\"] svg{color:#9c8873!important}[data-callout=\"tip\"]{--callout-bg: #391b06 !important;--callout-border: #8e4410 !important;--callout-icon: #b9825b !important;background:#391b06!important;border-color:#8e4410!important}[data-callout=\"tip\"] svg{color:#b9825b!important}[data-callout=\"warning\"]{--callout-bg: #310a0c !important;--callout-border: #7b181d !important;--callout-icon: #ab5e62 !important;background:#310a0c!important;border-color:#7b181d!important}[data-callout=\"warning\"] svg{color:#ab5e62!important}[data-callout=\"info\"]{--callout-bg: #232222 !important;--callout-border: #464543 !important;--callout-icon: #929190 !important;background:#232222!important;border-color:#464543!important}[data-callout=\"info\"] svg{color:#929190!important}[data-callout=\"check\"]{--callout-bg: #283126 !important;--callout-border: #647a5e !important;--callout-icon: #a2af9e !important;background:#283126!important;border-color:#647a5e!important}[data-callout=\"check\"] svg{color:#a2af9e!important}[data-callout]{color:#FFFFFF!important}[data-callout] p,[data-callout] span,[data-callout] li{color:#cdcccb!important}[data-callout] a{color:#cea181!important}[data-callout] a:hover{color:#e4c0a6!important}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):not(.card):not([class*=\"card\"]){color:var(--tw-prose-links);text-decoration:none;font-weight:600;border-bottom:1px solid rgba(142, 68, 16, 0.4);word-wrap:break-word;position:relative;z-index:10}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):not(.card):not([class*=\"card\"]):hover{border-bottom-color:rgba(142, 68, 16, 1)}.prose a[href*=\"llms.txt\"] code,.prose a[href*=\"llms-full.txt\"] code{background-color:rgba(142, 68, 16, 0.05);padding:2px 4px;border-radius:4px;font-family:ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, \"Liberation Mono\", \"Courier New\", monospace;font-size:0.9em}.prose a[href*=\"llms.txt\"]:hover code,.prose a[href*=\"llms-full.txt\"]:hover code{background-color:rgba(142, 68, 16, 0.08)}.link,.link>code{position:relative}.link{z-index:10}.flow-modal-overlay{z-index:2147483647!important;position:fixed!important}.flow-modal-overlay>*{position:relative;z-index:1}.method-nav-pill{display:none!important}#floating-assistant-container{display:none!important;position:fixed;left:0;right:0;bottom:0;padding:0 1rem 1rem;flex-direction:column;align-items:center;width:100%;z-index:20;pointer-events:none}#floating-assistant-wrapper{z-index:10;width:100%;max-width:24rem;transition:max-width 300ms ease-out, transform 300ms ease-out}#floating-assistant-wrapper:hover{transform:scale(1.05)}#floating-assistant-wrapper:focus-within{max-width:30rem;transform:scale(1)}#floating-assistant-form{display:flex;flex-direction:column;width:100%;border-radius:1rem;pointer-events:auto;background:rgba(255, 255, 255, 0.9);backdrop-filter:blur(24px);border:1px solid rgba(200, 200, 200, 0.3);box-shadow:0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 10px 10px -5px rgba(0, 0, 0, 0.04);transition:border-color 300ms}.dark #floating-assistant-form{background:rgba(30, 30, 30, 0.9);border-color:rgba(255, 255, 255, 0.3)}#floating-assistant-form:focus-within{border-color:#8e4410}.dark #floating-assistant-form:focus-within{border-color:#a36336}#floating-assistant-input-wrapper{position:relative;display:flex;align-items:end}#floating-assistant-input{width:100%;background:transparent;border:0;color:#111827;outline:none;padding:0.625rem 2.5rem 0.625rem 0.875rem;font-size:0.875rem;resize:none;height:60px!important;font-family:inherit}.dark #floating-assistant-input{color:#f3f4f6}#floating-assistant-input::placeholder{color:#6b7280}.dark #floating-assistant-input::placeholder{color:#9ca3af}#floating-assistant-shortcut-hint{position:absolute;right:2.75rem;bottom:0.75rem;font-size:0.75rem;font-weight:500;color:#9ca3af;user-select:none;pointer-events:none;display:none}@media (min-width: 640px){#floating-assistant-shortcut-hint{display:inline}}#floating-assistant-input:focus+#floating-assistant-shortcut-hint{display:none}#floating-assistant-submit{display:flex;justify-content:center;align-items:center;border-radius:9999px;padding:0.25rem;width:1.5rem;height:1.5rem;position:absolute;right:0.625rem;bottom:0.5rem;background:rgba(142, 68, 16, 0.3);border:none;cursor:not-allowed;transition:all 200ms}#floating-assistant-submit.active{background:#8e4410;cursor:pointer}#floating-assistant-submit.active:hover{background:#723609}.dark #floating-assistant-submit{background:rgba(163, 99, 54, 0.3)}.dark #floating-assistant-submit.active{background:#a36336}.dark #floating-assistant-submit.active:hover{background:#8e4410}#floating-assistant-submit svg{width:0.875rem;height:0.875rem;color:white}@media (max-width: 640px){#floating-assistant-wrapper{max-width:100%}#floating-assistant-wrapper:hover{transform:scale(1)}}body.dakota-env-switcher-mounted #sidebar-content{padding-bottom:5.5rem!important}#dakota-env-switcher{font-family:inherit;color:#f3f4f6;z-index:30}#dakota-env-switcher[data-in-sidebar=\"true\"]{position:absolute;left:1rem;right:1.25rem;bottom:1rem}#dakota-env-switcher[data-in-sidebar=\"false\"]{position:fixed;left:1rem;bottom:1rem;width:15rem;max-width:calc(100vw - 2rem)}#dakota-env-switcher[data-collapsed=\"true\"]{width:auto;right:auto}#dakota-env-toggle{display:flex;align-items:center;gap:0.5rem;width:100%;padding:0.5rem 0.75rem;border-radius:0.625rem;background:rgba(20, 20, 20, 0.92);border:1px solid rgba(255, 255, 255, 0.08);color:#f3f4f6;font-size:0.8125rem;font-weight:500;cursor:pointer;backdrop-filter:blur(16px);box-shadow:0 8px 20px -8px rgba(0, 0, 0, 0.45);transition:border-color 150ms ease, background 150ms ease}.light #dakota-env-toggle,html:not(.dark) #dakota-env-toggle{background:rgba(255, 255, 255, 0.95);border-color:rgba(0, 0, 0, 0.08);color:#1f2937}#dakota-env-toggle:hover{border-color:rgba(255, 255, 255, 0.18)}.light #dakota-env-toggle:hover,html:not(.dark) #dakota-env-toggle:hover{border-color:rgba(0, 0, 0, 0.18)}#dakota-env-switcher[data-collapsed=\"true\"] #dakota-env-toggle .dakota-env-label,#dakota-env-switcher[data-collapsed=\"true\"] #dakota-env-toggle .dakota-env-caret{display:none}#dakota-env-switcher .dakota-env-dot{width:0.5rem;height:0.5rem;border-radius:9999px;background:#d98e3e;flex-shrink:0;box-shadow:0 0 0 3px rgba(217, 142, 62, 0.18)}#dakota-env-switcher .dakota-env-dot[data-env=\"production\"]{background:#c63d3d;box-shadow:0 0 0 3px rgba(198, 61, 61, 0.18)}#dakota-env-switcher[data-env=\"production\"] #dakota-env-toggle .dakota-env-dot{background:#c63d3d;box-shadow:0 0 0 3px rgba(198, 61, 61, 0.18)}#dakota-env-switcher .dakota-env-label{flex:1;text-align:left;white-space:nowrap}#dakota-env-switcher .dakota-env-caret{opacity:0.6;flex-shrink:0;transition:transform 150ms ease}#dakota-env-switcher[data-open=\"true\"] .dakota-env-caret{transform:rotate(180deg)}#dakota-env-menu{display:none;margin-bottom:0.5rem;padding:0.375rem;border-radius:0.625rem;background:rgba(20, 20, 20, 0.96);border:1px solid rgba(255, 255, 255, 0.08);box-shadow:0 12px 30px -10px rgba(0, 0, 0, 0.55);backdrop-filter:blur(16px);position:absolute;bottom:100%;left:0;right:0}.light #dakota-env-menu,html:not(.dark) #dakota-env-menu{background:rgba(255, 255, 255, 0.98);border-color:rgba(0, 0, 0, 0.08)}#dakota-env-switcher[data-open=\"true\"] #dakota-env-menu{display:block}.dakota-env-menu-header{font-size:0.6875rem;font-weight:600;letter-spacing:0.04em;text-transform:uppercase;color:#9ca3af;padding:0.5rem 0.625rem 0.375rem}.light .dakota-env-menu-header,html:not(.dark) .dakota-env-menu-header{color:#6b7280}.dakota-env-option{display:flex;align-items:center;gap:0.625rem;width:100%;padding:0.5rem 0.625rem;background:transparent;border:none;border-radius:0.5rem;color:inherit;text-align:left;cursor:pointer;transition:background 120ms ease}.dakota-env-option:hover{background:rgba(255, 255, 255, 0.06)}.light .dakota-env-option:hover,html:not(.dark) .dakota-env-option:hover{background:rgba(0, 0, 0, 0.04)}.dakota-env-option-text{display:flex;flex-direction:column;flex:1;min-width:0}.dakota-env-option-title{font-size:0.8125rem;font-weight:500;line-height:1.1}.dakota-env-option-host{font-size:0.6875rem;color:#9ca3af;font-family:ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, \"Liberation Mono\", \"Courier New\", monospace;margin-top:0.125rem;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.light .dakota-env-option-host,html:not(.dark) .dakota-env-option-host{color:#6b7280}.dakota-env-check{opacity:0;color:#8e4410;flex-shrink:0}.dark .dakota-env-check{color:#cea181}.dakota-env-option[aria-selected=\"true\"] .dakota-env-check{opacity:1}.dakota-env-footer{font-size:0.6875rem;color:#9ca3af;padding:0.5rem 0.625rem 0.375rem;border-top:1px solid rgba(255, 255, 255, 0.06);margin-top:0.25rem;line-height:1.35}.light .dakota-env-footer,html:not(.dark) .dakota-env-footer{color:#6b7280;border-top-color:rgba(0, 0, 0, 0.06)}@media (max-width: 768px){#dakota-env-switcher{left:0.75rem;bottom:0.75rem;width:12rem}}[class*=\"Card_card\"]{padding:0.75rem!important}[class*=\"Card_card\"] h3,[class*=\"Card_card\"] [class*=\"title\"]{font-size:0.875rem!important;line-height:1.25rem!important}[class*=\"Card_card\"] p,[class*=\"Card_card\"] [class*=\"description\"]{font-size:0.75rem!important;line-height:1rem!important;margin-top:0.25rem!important}"}]}
{"page":{"pagePath":"documentation/cards/secure-card-data","slug":"/documentation/cards/secure-card-data","pageMetadata":{"title":"Secure Card Data","description":"Show a cardholder their card number, expiry, and CVV without that data touching your servers or Dakota's","href":"/documentation/cards/secure-card-data"},"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: \"Show a cardholder their card number, expiry, and CVV without that data touching your servers or Dakota’s\"\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`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Mermaid,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Cards is available in sandbox only while we finish development.`}),` Dakota enables Cards per\naccount. The Cards endpoints are in the `,_jsx(_components.a,{href:`/api-reference/introduction`,children:`API reference`}),`, marked\n`,_jsx(_components.strong,{children:`Sandbox only`}),`. Endpoints, fields, and flows can still change before release.`]})}),`\n`,_jsxs(_components.p,{children:[`No Dakota endpoint or webhook returns the full card number (PAN), expiry, or CVV. The most any card object carries is `,_jsx(_components.code,{children:`last4`}),`. To show the details, your backend mints a short-lived `,_jsx(_components.strong,{children:`reveal session`}),`, and `,_jsx(_components.a,{href:`/documentation/cards/cards-js`,children:`Cards.js`}),` uses it to render the values in the cardholder’s browser, inside a frame served by the card-data processor. The values never pass through your backend or Dakota’s.`]}),`\n`,_jsx(Mermaid,{chart:`sequenceDiagram\n participant U as Cardholder's browser\n participant JS as Cards.js\n participant BE as Your backend\n participant D as Dakota API\n participant P as Card-data processor\n\n U->>JS: Taps \"Show details\"\n JS->>BE: fetchSession({sessionType, origin})\n BE->>BE: Authenticate the user, confirm they own the card\n BE->>D: POST /cards/{card_id}/reveal_session\n D-->>BE: {session, expires_at}\n BE-->>JS: {session, expiresAt}\n JS->>P: Redeem the session\n P-->>U: Card number, expiry, CVV`}),`\n`,_jsx(Heading,{level:`2`,id:`mint-a-reveal-session`,children:`Mint a reveal session`}),`\n`,_jsxs(_components.p,{children:[`Call `,_jsx(_components.a,{href:`/api-reference/cards/create-a-card-reveal-session`,children:_jsx(_components.code,{children:`POST /cards/{card_id}/reveal_session`})}),` from your backend. Your frontend never holds a Dakota API key.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`13`,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:`13`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`POST /cards/{`}),_jsx(_components.span,{style:{color:`#82071E`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#F44747`,\"--shiki-dark-font-style\":`inherit`},children:`card_id`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}/reveal_session`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`x-api-key: \u003cYOUR_DAKOTA_API_KEY>`})}),`\n`,_jsx(_components.span,{className:`line`}),`\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:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"session_type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"card_details\"`}),_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:` \"origin\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://app.example.com\"`})]}),`\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:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`200`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` OK`})]}),`\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:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"session\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003copaque single-use credential>\"`}),_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:` \"expires_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-07-22T15:04:05Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`origin`}),` is the HTTPS origin of the page that shows the card: scheme, host, and a port if it is not the default, with no path. A trailing `,_jsx(_components.code,{children:`/`}),` counts as a path and returns `,_jsx(_components.code,{children:`400`}),`. The session only works on that origin. Plain `,_jsx(_components.code,{children:`http://localhost`}),` is rejected, including in development.`]}),`\n`,_jsxs(_components.li,{children:[`Cards.js sends `,_jsx(_components.code,{children:`sessionType`}),` and expects `,_jsx(_components.code,{children:`expiresAt`}),`. Your backend renames `,_jsx(_components.code,{children:`sessionType`}),` to `,_jsx(_components.code,{children:`session_type`}),` on the request to Dakota, and `,_jsx(_components.code,{children:`expires_at`}),` to `,_jsx(_components.code,{children:`expiresAt`}),` on the response it returns to Cards.js.`]}),`\n`,_jsxs(_components.li,{children:[`Do not send an `,_jsx(_components.code,{children:`X-Idempotency-Key`}),`. Every call mints a new session, including a retry.`]}),`\n`,_jsxs(_components.li,{children:[`Use the host that matches the `,_jsx(_components.code,{children:`environment`}),` you give Cards.js.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Rules to design around:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`One session per reveal.`}),` A session works once. To show the details again, mint a new one.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Short-lived.`}),` A session expires 5 minutes after it is minted.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[`The card must be `,_jsx(_components.code,{children:`active`}),`.`]}),` A `,_jsx(_components.code,{children:`pending`}),`, `,_jsx(_components.code,{children:`frozen`}),`, `,_jsx(_components.code,{children:`overdrawn`}),`, or `,_jsx(_components.code,{children:`closed`}),` card cannot mint a session. A `,_jsx(_components.code,{children:`closed`}),` card is refused with `,_jsx(_components.code,{children:`403 card-closed`}),`. Check the card’s `,_jsx(_components.code,{children:`status`}),` before you mint: today Dakota refuses a `,_jsx(_components.code,{children:`pending`}),`, `,_jsx(_components.code,{children:`frozen`}),` or `,_jsx(_components.code,{children:`overdrawn`}),` card with a `,_jsx(_components.code,{children:`5xx`}),`, not a `,_jsx(_components.code,{children:`4xx`}),`, so the response alone does not tell you why.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Rate limited.`}),` Any of your API keys can mint sessions, up to 60 per minute and 600 per hour for your account. Over that, the call returns `,_jsx(_components.code,{children:`429`}),`.`]}),`\n`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Your backend is the access check.`}),` Dakota verifies that the card belongs to your account, but it cannot know which of your users is asking. Authenticate the user and confirm they own the card before every mint. Without that check, any signed-in user could reveal any of your cards.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`show-it-with-cards-js`,children:`Show it with Cards.js`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/documentation/cards/cards-js`,children:`Cards.js`}),` (`,_jsx(_components.code,{children:`@dakota-xyz/cards-js`}),`) renders a masked card, mints a session through your backend when the user asks, reveals the values, and masks them again when the session window ends. It has React bindings.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/documentation/cards/cards-js`,children:`Quickstart`}),` for vanilla JavaScript and React`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/documentation/cards/cards-js/integration-guide`,children:`Integration guide`}),`, including the backend endpoint`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/documentation/cards/cards-js/network-and-csp`,children:`Network \u0026 CSP`}),`: the frame origins your content security policy must allow`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Showing card details needs a browser application. A Dakota-hosted reveal page for integrations without a frontend is planned.`})]})}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":"Secure Card Data","description":"Show a cardholder their card number, expiry, and CVV without that data touching your servers or Dakota's","href":"/documentation/cards/secure-card-data"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Mint a reveal session","slug":"mint-a-reveal-session","depth":2,"children":[]},{"title":"Show it with Cards.js","slug":"show-it-with-cards-js","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/dakota-49818541/166e91537ad3bb02/public/floating-assistant.js","/_mintlify/custom/dakota-49818541/98e4ee9d2a52c1e3/public/env-switcher.js"],"subdomain":"dakota-49818541","siteName":"Dakota","title":"Secure Card Data - Dakota","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-06T10:55:35.562Z","originalFileLocation":"documentation/cards/secure-card-data.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=\"dark\"}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=\"Show a cardholder their card number, expiry, and CVV without that data touching your servers or Dakota\u0026#x27;s\">\u003cmeta data-mint-head name=\"application-name\" content=\"Dakota\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/dakota-49818541/PW4ddHpkUE3rJR0e/_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/dakota-49818541/PW4ddHpkUE3rJR0e/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dakota-49818541/PW4ddHpkUE3rJR0e/_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/dakota-49818541/PW4ddHpkUE3rJR0e/_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/dakota-49818541/PW4ddHpkUE3rJR0e/_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/dakota-49818541/PW4ddHpkUE3rJR0e/_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/dakota-49818541/PW4ddHpkUE3rJR0e/_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/dakota-49818541/PW4ddHpkUE3rJR0e/_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/dakota-49818541/PW4ddHpkUE3rJR0e/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Secure Card Data - Dakota\">\u003cmeta data-mint-head property=\"og:description\" content=\"Show a cardholder their card number, expiry, and CVV without that data touching your servers or Dakota\u0026#x27;s\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Dakota\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.dakota.xyz/documentation/cards/secure-card-data\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://dakota-49818541.mintlify.site/_mintlify/api/og/v2?division=Cards\u0026amp;title=Secure+Card+Data\u0026amp;description=Show+a+cardholder+their+card+number%2C+expiry%2C+and+CVV+without+that+data+touching+your+servers+or+Dakota%27s\u0026amp;theme=b4f99b33160b9781c71dd798\u0026amp;signature=ef3048f9e977a73b0b193b17ea5c1a06da05443c55946f0855ce6a30c1ad7281\">\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=\"Secure Card Data - Dakota\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Show a cardholder their card number, expiry, and CVV without that data touching your servers or Dakota\u0026#x27;s\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://dakota-49818541.mintlify.site/_mintlify/api/og/v2?division=Cards\u0026amp;title=Secure+Card+Data\u0026amp;description=Show+a+cardholder+their+card+number%2C+expiry%2C+and+CVV+without+that+data+touching+your+servers+or+Dakota%27s\u0026amp;theme=b4f99b33160b9781c71dd798\u0026amp;signature=ef3048f9e977a73b0b193b17ea5c1a06da05443c55946f0855ce6a30c1ad7281\">\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/dakota-49818541/PW4ddHpkUE3rJR0e/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Dakota\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#8e4410\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.dakota.xyz/documentation/cards/secure-card-data\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/documentation/cards/secure-card-data.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.dakota.xyz/#organization\",\"name\":\"Dakota\",\"url\":\"https://docs.dakota.xyz\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/dakota-49818541/-tkRmX-DtPxqfDgt/images/dakota-logo-black.png?fit=max\u0026auto=format\u0026n=-tkRmX-DtPxqfDgt\u0026q=85\u0026s=c409f7b8cec2e984bd0c79735f637bfe\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.dakota.xyz#website\",\"name\":\"Dakota\",\"url\":\"https://docs.dakota.xyz\",\"publisher\":{\"@id\":\"https://docs.dakota.xyz/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.dakota.xyz/documentation/cards/secure-card-data#webpage\",\"url\":\"https://docs.dakota.xyz/documentation/cards/secure-card-data\",\"name\":\"Secure Card Data\",\"description\":\"Show a cardholder their card number, expiry, and CVV without that data touching your servers or Dakota's\",\"dateModified\":\"2026-11-06T10:55:35.562Z\",\"isPartOf\":{\"@id\":\"https://docs.dakota.xyz#website\"},\"breadcrumb\":{\"@id\":\"https://docs.dakota.xyz/documentation/cards/secure-card-data#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.dakota.xyz/documentation/cards/secure-card-data#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Cards\",\"item\":\"https://docs.dakota.xyz/documentation/cards\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Secure Card Data\",\"item\":\"https://docs.dakota.xyz/documentation/cards/secure-card-data\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.dakota.xyz/documentation/cards/secure-card-data#article\",\"headline\":\"Secure Card Data\",\"name\":\"Secure Card Data\",\"description\":\"Show a cardholder their card number, expiry, and CVV without that data touching your servers or Dakota's\",\"url\":\"https://docs.dakota.xyz/documentation/cards/secure-card-data\",\"mainEntityOfPage\":{\"@id\":\"https://docs.dakota.xyz/documentation/cards/secure-card-data#webpage\"},\"dateModified\":\"2026-11-06T10:55:35.562Z\",\"publisher\":{\"@id\":\"https://docs.dakota.xyz/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.dakota.xyz#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Dakota\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Dakota\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/documentation/cards/secure-card-data.md","siteName":"Dakota","nav":{"global":{"anchors":[{"anchor":"Support","icon":"headset","href":"https://support.dakota.xyz"},{"anchor":"Contact us","icon":"envelope","href":"https://dakota.xyz/talk-to-sales"}]},"tabs":[{"tab":"Documentation","groups":[{"group":"Playground","pages":[{"title":"Interactive API Playground","href":"/documentation/try-it-now"},{"title":"Create Your Flow","href":"/documentation/create-your-flow"}]},{"group":"Documentation","pages":[{"title":"Get Started","href":"/index"},{"title":"Common Flows","href":"/documentation/common-flows"},{"title":"Advanced Flows","href":"/documentation/advanced-flows"},{"title":"Foreign exchange (FX)","href":"/documentation/fx"},{"title":"Terminology \u0026 Key Concepts","href":"/documentation/terminology"},{"title":"Customer Onboarding","href":"/documentation/customer-onboarding"},{"title":"Sub-Clients","href":"/documentation/sub-clients"},{"title":"Destinations \u0026 Recipients","href":"/documentation/destinations-recipients"},{"title":"Webhook Integration","href":"/documentation/webhooks"},{"title":"Testing Your Integration","href":"/documentation/testing"},{"title":"Wallets","href":"/documentation/wallets"},{"title":"Policies","href":"/documentation/policies"},{"title":"Wallet Transaction Signing","href":"/documentation/wallet-signing"},{"title":"WebAuthn \u0026 Passkey Signing","href":"/documentation/webauthn-signing"},{"title":"Signing \u0026 Endorsed Requests","href":"/documentation/signing-guide"},{"title":"Governance Signing with the SDKs","href":"/documentation/sdk-governance-signing"}]},{"group":"Import Share Tokens","pages":[{"group":"Sumsub Token Sharing","pages":[{"title":"Sumsub Token Sharing","sidebarTitle":"Overview","href":"/documentation/sumsub-token-sharing"},{"title":"Importing Sumsub Tokens","sidebarTitle":"Importing Tokens","href":"/documentation/sumsub-token-import"}]},{"group":"Persona Token Sharing","pages":[{"title":"Persona Token Sharing","sidebarTitle":"Overview","href":"/documentation/persona-token-sharing"},{"title":"Importing Persona Tokens","sidebarTitle":"Importing Tokens","href":"/documentation/persona-token-import"}]},{"title":"Completing an Imported Application","sidebarTitle":"Completing Application","href":"/documentation/completing-an-imported-application"}]},{"group":"Agentic Payments","pages":[{"title":"Agentic Payments","href":"/documentation/agentic-payments/index"},{"title":"Agentic Payments Quickstart","href":"/documentation/agentic-payments/quickstart"},{"title":"Agentic Payment Examples","href":"/documentation/agentic-payments/examples"},{"title":"Direct Control: Mandates \u0026 Scheduled Payments","href":"/documentation/agentic-payments/direct-control"},{"title":"Mandate Signing","href":"/documentation/agentic-payments/mandate-signing"},{"title":"Agentic Webhooks","href":"/documentation/agentic-payments/webhooks"},{"title":"Account Insights","href":"/documentation/agentic-payments/insights"},{"title":"Client Insights","href":"/documentation/agentic-payments/client-insights"},{"title":"Client Policy","href":"/documentation/agentic-payments/client-policy"},{"title":"Agentic Limits \u0026 Support Matrix","href":"/documentation/agentic-payments/limits"},{"group":"x402","pages":[{"title":"x402 Payments","href":"/documentation/agentic-payments/x402/index"},{"title":"x402 Quickstart","href":"/documentation/agentic-payments/x402/quickstart"},{"title":"x402 Budgets \u0026 Holds","href":"/documentation/agentic-payments/x402/budgets-and-holds"}]}]},{"group":"Cards","tag":"Coming Soon","pages":[{"title":"Cards","href":"/documentation/cards/index"},{"title":"Cards API Recipes","sidebarTitle":"API Recipes","href":"/documentation/cards/api-recipes"},{"title":"Activating Customers for Cards","sidebarTitle":"Activating Customers","href":"/documentation/cards/activation"},{"title":"Cardholders","href":"/documentation/cards/cardholders"},{"title":"Wallet Card Enablement","sidebarTitle":"Wallet Enablement","href":"/documentation/cards/wallet-enablement"},{"title":"Issuing and Managing Cards","sidebarTitle":"Issuing \u0026 Managing","href":"/documentation/cards/issuing"},{"title":"Card Funding","sidebarTitle":"Funding","description":"How a purchase holds, clears, and settles against the wallet's available balance","href":"/documentation/cards/card-funding"},{"title":"Secure Card Data","href":"/documentation/cards/secure-card-data"},{"group":"Cards.js","pages":[{"title":"Cards.js","sidebarTitle":"Overview","description":"Show a cardholder their full card details in your web app, without the card data touching your DOM, your servers, or your code","href":"/documentation/cards/cards-js/index"},{"title":"Cards.js Integration Guide","sidebarTitle":"Integration guide","href":"/documentation/cards/cards-js/integration-guide"},{"title":"Cards.js API Reference","sidebarTitle":"API reference","href":"/documentation/cards/cards-js/api-reference"},{"title":"Cards.js Theming \u0026 Internationalization","sidebarTitle":"Theming","href":"/documentation/cards/cards-js/theming"},{"title":"Cards.js Network \u0026 Content-Security-Policy","sidebarTitle":"Network \u0026 CSP","href":"/documentation/cards/cards-js/network-and-csp"},{"title":"Cards.js Security","sidebarTitle":"Security","href":"/documentation/cards/cards-js/security"},{"title":"Cards.js Changelog","sidebarTitle":"Changelog","href":"/documentation/cards/cards-js/changelog"}]},{"title":"Cards Webhooks","sidebarTitle":"Webhooks","href":"/documentation/cards/webhooks"},{"title":"Card Disputes","sidebarTitle":"Disputes","href":"/documentation/cards/disputes"},{"title":"Testing Cards","sidebarTitle":"Testing","href":"/documentation/cards/testing-sandbox"}]},{"group":"Authentication","pages":[{"title":"Authentication","href":"/documentation/authentication/index"},{"title":"API Keys \u0026 Headers","href":"/documentation/authentication/api-keys-headers"},{"title":"API Key Scopes","href":"/documentation/authentication/api-key-scopes"},{"title":"Rate Limiting","href":"/documentation/authentication/rate-limiting"},{"title":"Security","href":"/documentation/authentication/security"},{"title":"Troubleshooting","href":"/documentation/authentication/troubleshooting"}]},{"group":"Developer Tools","pages":[{"title":"SDKs \u0026 Libraries","href":"/documentation/sdks"},{"title":"MCP Server","href":"/documentation/mcp-server"},{"title":"Using LLMs","href":"/documentation/using-llms"},{"title":"auth.md","sidebarTitle":"Agent registration","href":"/auth"}]}]},{"tab":"API reference","pages":[{"title":"API reference","href":"/api-reference/introduction"}]}]},"basePath":"","title":"Secure Card Data - Dakota","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}