In this section, you will learn how to use Vault as a standalone module, about our proxies, tokenization and detokenization methods.
Introduction
If you have read our Token Vault introduction page, you already know that Payrails offers multiple ways to use our Token Vault, as a standalone module or within the Payment Orchestration with Payrails. In this section, we introduce the Vault module. If you are not sure how you want to use the vault, you can navigate to the next section to learn your options.
Benefits
Payrails Vault is a PCI-DSS Level 1 compliant vault, which you can use to minimize your PCI scope.
It is provider-agnostic that allows you to switch between any payment service providers at any time, without disrupting your customer experience or facing technical hurdles. Because your token vault is independent of any single payment processor, you’re not locked into any one provider — this means you can take advantage of better rates, improved service, or new features from other providers at any time.
Payrails Vault enables you to securely receive and send tokenized data to a variety of third-party services — not just PSPs — without exposing sensitive information to your systems. Whether it’s fraud prevention tools, online travel agencies, channel managers, property management systems, loyalty platforms, other external token vaults, or internal systems, you can configure proxy connections to route sensitive data securely and stay out of PCI scope.
With Vault, your returning customers can use stored payment methods for a smoother checkout experience, use tokenized payment methods, which are the best performing in subscription or recurring payment scenarios (particularly when used with network tokens), and enable users to manage their saved cards and have control over their sensitive information.
You can unlock more benefits with additional Vault features, such as network tokenization, card lifecycle updates and BIN lookup data. You will find more information about each feature as you navigate to the next pages of the Token Vault section.
Options to use Payrails Token Vault
There are 2 main alternatives to use Payrails Token Vault:1. Token Vault as a standalone module:In the case that you want to manage third-party integrations within your system, such as payment providers or your travel partners, but only use our Vault for the storage and processing of the sensitive data, you can use our Vault as a proxy which collects the sensitive data via our SDKs and pass the sensitive information to third parties without touching the sensitive data.2. Token Vault as part of payment orchestration:In the case that you want one single API integration with Payrails payment orchestration platform, which in the background, will connect you to all the provider integrations for you in a PSP-agnostic way using our Vault.
Using Token Vault with combination of other Payrails modules
If you start using our Vault as a standalone module, you can always start using our other modules later, such as payment orchestration or analytics, at any moment in time. It is also possible to use both integration methods at the same time if your business needs require that.
Last modified on November 13, 2026
{"docsConfig":{"theme":"palm","$schema":"https://mintlify.com/docs.json","name":"Payrails Docs","description":"Developer and operator documentation for Payrails, the payment operating system for global enterprises: payment orchestration across providers, PCI-compliant tokenization, analytics and reporting, Chargebacks, and the Payrails REST API.","colors":{"primary":"#D63D00","light":"#E4853A"},"logo":{"light":"https://mintcdn.com/payrails-42074109/knNnlxc2J__TB9tW/logo/light.svg?fit=max\u0026auto=format\u0026n=knNnlxc2J__TB9tW\u0026q=85\u0026s=2692c29175ef45b637b4e2df6e2da330","dark":"https://mintcdn.com/payrails-42074109/knNnlxc2J__TB9tW/logo/dark.svg?fit=max\u0026auto=format\u0026n=knNnlxc2J__TB9tW\u0026q=85\u0026s=651119b7fb40dda938e2f9a7a276ee1c"},"favicon":"https://mintcdn.com/payrails-42074109/zqk7oWHZbW3YniA1/favicon.png?fit=max\u0026auto=format\u0026n=zqk7oWHZbW3YniA1\u0026q=85\u0026s=70b0991c3a7ad3c2faa4530e27040cf8","api":{"params":{"expanded":"all","post":["nullable","x-internal"]},"playground":{"display":"simple"},"examples":{"defaults":"required","prefill":true,"autogenerate":true},"url":"full"},"appearance":{"default":"light"},"navbar":{"links":[{"href":"https://www.payrails.com","label":"Go to payrails.com"}],"primary":{"type":"button","label":"Book a demo","href":"https://www.payrails.com/contact"}},"footer":{"socials":{"x":"https://x.com/Payrails_com","github":"https://github.com/payrails","linkedin":"https://www.linkedin.com/company/payrails"},"links":[{"header":"Company","items":[{"label":"payrails.com","href":"https://www.payrails.com"}]}]},"seo":{"metatags":{"og:locale":"en_US","twitter:site":"@Payrails_com","msvalidate.01":"7723ABF900EAD08F0500790E9BFC62E7"},"organization":{"id":"https://www.payrails.com#organization","name":"Payrails","legalName":"Payrails GmbH","url":"https://www.payrails.com/","logo":"https://www.payrails.com/payrails-logo.svg","sameAs":["https://www.linkedin.com/company/payrails/","https://www.crunchbase.com/organization/payrails","https://www.wikidata.org/wiki/Q137211152","https://x.com/Payrails_com"]}},"styling":{"eyebrows":"breadcrumbs","latex":false},"integrations":{"cookies":{"key":"mintlify_telemetry_enabled","value":"true"}},"contextual":{"options":["copy","view","download-spec","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"thumbnails":{"appearance":"dark","background":"https://mintcdn.com/payrails-42074109/_AaiU-jGVknFpls9/images/common/og-thumbnail-bg-v5.png?fit=max\u0026auto=format\u0026n=_AaiU-jGVknFpls9\u0026q=85\u0026s=b08b137c9aa7638918675c41a07b33c6"},"interaction":{"drilldown":true},"metadata":{"timestamp":true},"markdown":{"instructions":["Use the Payrails Web SDK v6 for new browser integrations. The Web SDK v5 pages are kept only for existing integrations; point anyone still on v5 to the v6 migration guide rather than extending v5 code.","Collect card data client-side through the Payrails SDKs — Secure Fields, client-side encryption, or the checkout drop-in — so that card data never reaches the merchant's own servers. Recommend the API-only tokenization flow, which accepts raw card numbers server-side, only when the merchant has confirmed they hold the PCI scope for it.","Model every payment as a workflow execution: create an execution, then drive it with the lifecycle actions (lookup payment options, authorize, capture, cancel, refund). Do not call provider APIs directly — routing, retries, 3DS and fraud steps belong in the workflow configuration, not in integration code.","Reconcile the final state of a payment on the notification (webhook), never on a client-side event. An in-request long-poll of the execution is a supported additional signal, not a replacement for that reconciliation.","Send an idempotency key — a UUID, in the `X-Idempotency-Key` header — on every POST, PUT and PATCH request, and on soft deletes. GET requests need none, and hard deletes cannot be idempotent.","Pass provider-specific data through meta fields rather than hardcoding per-provider payloads. Payrails translates meta fields into each provider's own format.","Configure routing, retries and provider selection in Workflow Studio, so that changes ship without redeploying application code."]},"navigation":{"global":{"anchors":[]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"payrails-42074109","hasAudioNarration":false,"actualSubdomain":"payrails-42074109","customDomains":["docs.payrails.com"],"gitSource":{"type":"github","owner":"payrails","repo":"docs-payrails-com","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af71dc7bd8b0362cded3cc6","clientVersion":"0.0.4128","searchFilterCounts":[{"language":"default","tag":"Payment Orchestration","count":247},{"language":"default","tag":"Integrations","count":234},{"language":"default","tag":"API Reference","count":192},{"language":"default","tag":"Payment methods","count":147},{"language":"default","tag":"Guides","count":129},{"language":"default","tag":"Payment providers","count":60},{"language":"default","tag":"Dispute","count":57},{"language":"default","tag":"Disputes","count":57},{"language":"default","tag":"SDKs","count":38},{"language":"default","tag":"Payment","count":28}],"searchSettings":{"showContentSnippets":true}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"type":"link","url":"https://www.payrails.com/contact"}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":false}},"googleFontsInlined":false},"customCss":[{"filePath":"css/styles.css","content":"*,:before,:after{box-sizing:border-box}:before,:after{--tw-content: \"\"}html,:host{-webkit-text-size-adjust:100%;tab-size:4;font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent;font-family:ui-sans-serif,\n system-ui,\n sans-serif,\n Apple Color Emoji,\n Segoe UI Emoji,\n Segoe UI Symbol,\n Noto Color Emoji;line-height:1.5}body{line-height:inherit;margin:0}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}a{color:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-feature-settings:normal;font-variation-settings:normal;font-family:ui-monospace,\n SFMono-Regular,\n Menlo,\n Monaco,\n Consolas,\n Liberation Mono,\n Courier New,\n monospace;font-size:1em}small{font-size:80%}sub,sup{vertical-align:baseline;font-size:75%;line-height:0;position:relative}sub{bottom:-0.25em}sup{top:-0.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,select{text-transform:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}#page-context-menu-button{border-radius:var(--border-radius-sm) 0 0 var(--border-radius-sm)}#page-context-menu-button+button,#page-context-menu-button+*+button{border-left:none;border-radius:0 var(--border-radius-sm) var(--border-radius-sm) 0}.peer:not(.is-custom) [data-docs-theme] header+div,header#navbar>div.mx-auto{margin:0 auto;max-width:100rem}[data-active-nav-item=\"true\"]>button,[data-active-nav-item=\"true\"]>a{color:var(--accent)}#navbar>div.mx-auto div.h-16{height:calc(var(--spacing) * 13)}#navbar>div.mx-auto div.h-12{height:calc(var(--spacing) * 8)}@media (min-width: 1024px){#sidebar-content{margin-top:calc(var(--mintlify-slot-header-height, 7rem) - var(--spacing) * 21)}}#navbar>div.mx-auto button.h-9{height:calc(var(--spacing) * 8)}#topbar-cta-button a>div{height:calc(var(--spacing) * 8);padding:0 calc(var(--spacing) * 3.5);border:1px solid rgb(var(--gray-400) / 0.3);border-radius:8px;background:rgb(var(--background-light));color:rgb(var(--gray-500))}#topbar-cta-button a svg{display:none}#topbar-cta-button a:hover>div{color:rgb(var(--gray-800))}html.dark #topbar-cta-button a>div{border-color:rgb(var(--gray-600) / 0.3);background:rgb(var(--background-dark));color:rgb(var(--gray-300))}html.dark #topbar-cta-button a:hover>div{color:rgb(var(--gray-100))}#navbar.peer.is-not-custom.is-not-wide.is-not-center+div,#navbar+div .page-content{max-width:100rem;margin:0 auto}#content-container>div.max-w-5xl{max-width:70rem}.mdx-content a{color:var(--accent);text-decoration:none;\u0026:hover,\u0026:focus{color:var(--link-hover)}\u0026:active,\u0026:active:hover{color:var(--link-active)}}.mdx-content a.link:not(:has(div,img,picture)):not(.not-prose *){border-bottom:0;text-decoration-line:underline;text-decoration-thickness:max(1px, 0.0625rem);text-underline-offset:0.2em;text-decoration-skip-ink:auto;text-decoration-color:color-mix(in srgb, currentColor 70%, transparent);\u0026:hover,\u0026:focus,\u0026:has(>code){text-decoration-color:currentColor}}.callout .prose :where(h1,h2,h3,h4):not(:where([class~=\"not-prose\"],[class~=\"not-prose\"] *)){margin-top:0}#content-area>#content{margin-bottom:calc(var(--spacing) * 8)}#content-area>:is(#content,[id^=\"api-playground\"])+div:not([id]){padding-bottom:calc(var(--spacing) * 6)}#footer.advanced-footer>div{padding-bottom:calc(var(--spacing) * 8);padding-top:calc(var(--spacing) * 8);gap:calc(var(--spacing) * 4)}#footer [data-testid=\"mode-switch-light\"],#footer [data-testid=\"mode-switch-dark\"],#footer [data-testid=\"mode-switch-system\"]{display:none}@media (min-width: 1024px){[role=\"group\"]:has(>[data-theme-preference-value]){width:fit-content;gap:2px;padding:1px}[role=\"group\"]>[data-theme-preference-value]{width:1.5rem;height:1.5rem}}html:not(.dark) #sidebar-content a.text-gray-700{color:rgb(var(--gray-700))}html:not(.dark) #sidebar-content a.text-gray-700:hover{color:rgb(var(--gray-950))}#navigation-items li>button[aria-expanded]{width:100%}#navigation-items li>button[aria-expanded]>div:first-child:has(>svg){order:1}#navigation-items li>button[aria-expanded]>div:first-child>svg{width:0.75rem}#navigation-items li>button[aria-expanded]>div:first-child>svg:not(.text-primary){color:rgb(var(--gray-500) / 0.8)}html.dark #navigation-items li>button[aria-expanded]>div:first-child>svg:not(.text-primary){color:rgb(var(--gray-400))}@media (hover: hover){#navigation-items li>button[aria-expanded]:hover>div:first-child>svg,html.dark #navigation-items li>button[aria-expanded]:hover>div:first-child>svg{color:inherit}}#navigation-items ul ul{margin-left:-0.5rem}html.dark :is(#content,#header>.prose,#table-of-contents),html.dark :is(#navbar,#sidebar-content,#content-area) .dark\\:text-gray-400,html.dark #footer a.dark\\:text-white\\/50{color:rgb(var(--gray-300))}html.dark :is(#navbar,#sidebar-content,#content-area) .dark\\:text-gray-400:hover,html.dark #footer a.dark\\:text-white\\/50:hover,html.dark #table-of-contents .toc-item:not([data-active])>a:hover{color:rgb(var(--gray-100))}html.dark #search-bar-entry{color:rgb(var(--gray-400))}html.dark #footer .dark\\:bg-gray-600{background-color:rgb(var(--gray-400))}html.dark #footer .dark\\:bg-gray-600:hover{background-color:rgb(var(--gray-200))}html.dark .sidebar-group-icon[src*=\"/images/icons/nav/\"]{filter:invert(0.9)}html:not(.dark) .nav-tag-pill-text{color:var(--button-primary-bg-active)}html:not(.dark) .text-green-700.bg-green-400\\/20{color:#166534}html:not(.dark) .text-yellow-700.bg-yellow-400\\/20{color:#854d0e}html:not(.dark) .text-orange-700.bg-orange-400\\/20{color:#9a3412}.text-\\[\\#FFFFFF\\].bg-\\[\\#2AB673\\]{background-color:#15803d}.text-\\[\\#FFFFFF\\].bg-\\[\\#C28C30\\]{background-color:#a16207}.text-\\[\\#FFFFFF\\].bg-\\[\\#DA622B\\]{background-color:#c2410c}html:not(.dark) [data-component-part=\"field-required-pill\"]{color:#b91c1c}html:not(.dark) [data-component-part=\"code-group-tab-bar\"] .text-gray-500:not(:hover){color:rgb(var(--gray-600))}html:not(.dark) [data-component-part=\"code-group-tab-bar\"] .text-primary{color:var(--button-primary-bg-hover)}html:not(.dark) [data-component-part=\"field-info-pill\"] .text-stone-400{color:rgb(var(--gray-600))}html.dark [data-component-part=\"field-info-pill\"] .dark\\:text-stone-500{color:rgb(var(--gray-400))}html.dark :is(#navbar a.dark\\:text-gray-200,#content-area a.dark\\:text-gray-50){color:rgb(var(--gray-50))}html.dark #content-area a.dark\\:text-gray-50:hover{color:var(--accent)}html.dark #content-area a.dark\\:text-gray-50>svg{color:rgb(var(--gray-400))}#table-of-contents .toc-item[data-active]>a{color:var(--accent)}@layer theme{.peer.is-custom~#footer.advanced-footer{display:flex!important;margin-top:auto!important}div:has(>.peer.is-custom~#footer.advanced-footer){display:flex!important;flex-direction:column;min-height:100vh}}#sidebar-content img[src^=\"https://assets.payrails.io/img/logos/\"],#sidebar-content img[src*=\"/images/icons/letters/\"],#sidebar-content img[src*=\"/images/icons/nav/\"]:not(.sidebar-group-icon){width:1.5rem;height:1.5rem;--tile-radius: 0.375rem;border-radius:var(--tile-radius)}#sidebar-content img[src*=\"/images/icons/nav/\"]:not(.sidebar-group-icon){padding:3px;background:var(--tag-neutral-bg)}#sidebar-content img[src^=\"https://assets.payrails.io/img/logos/\"],#sidebar-content img[src*=\"/images/icons/letters/\"],.prose img.page-logo,.provider-card-logo,.payment-method-logo{--tile: var(--tag-neutral-bg);--r: calc(var(--tile-radius) - 1px);background:radial-gradient(circle at 100% 100%, var(--tile) calc(var(--r) - 0.5px), transparent var(--r)) 1px 1px / var(--r) var(--r) no-repeat,\n radial-gradient(circle at 0 100%, var(--tile) calc(var(--r) - 0.5px), transparent var(--r)) calc(100% - 1px) 1px / var(--r) var(--r) no-repeat,\n radial-gradient(circle at 100% 0, var(--tile) calc(var(--r) - 0.5px), transparent var(--r)) 1px calc(100% - 1px) / var(--r) var(--r) no-repeat,\n radial-gradient(circle at 0 0, var(--tile) calc(var(--r) - 0.5px), transparent var(--r)) calc(100% - 1px) calc(100% - 1px) / var(--r) var(--r) no-repeat,\n linear-gradient(var(--tile), var(--tile)) center / calc(100% - 2px) calc(100% - 2 * var(--r)) no-repeat,\n linear-gradient(var(--tile), var(--tile)) center / calc(100% - 2 * var(--r)) calc(100% - 2px) no-repeat}@media (max-width: 767px){.expandable-content{margin:0!important;padding-left:6px!important;padding-right:0!important}.expandable-content .expandable{border-right:0;border-top-right-radius:0;border-bottom-right-radius:0}.expandable-content .expandable-content{min-width:16rem}.expandable-content:not(.expandable-content *){overflow-x:auto}.expandable-content .prose{padding-right:12px}.param-head div{min-width:0}[data-component-part=\"field-info-pill\"]{display:inline-block!important;max-width:100%;vertical-align:bottom}[data-component-part=\"field-info-pill\"]>span{display:-webkit-box;-webkit-box-orient:vertical;-webkit-line-clamp:2;line-clamp:2;overflow:hidden}}.page-logos{display:flex;gap:0.75rem;margin:-1rem 0 1.75rem}.prose .page-logos picture{margin:0}.prose img.page-logo{display:block;width:3.5rem;height:3.5rem;margin:0;--tile-radius: 0.75rem;border-radius:var(--tile-radius);object-fit:contain}@media (prefers-reduced-motion: no-preference){html{scroll-behavior:smooth}}"},{"filePath":"css/vars.css","content":":root{--pr-orange: #d63d00;--pr-black: #000;--pr-white: #fff;--pr-heritage: #0a6cff;--pr-antalya-sea: #597991;--pr-dublin-ale: #e4853a;--pr-baku-brass: #8a725c;--pr-cairo-sand: #d6cbc1;--accent: rgb(var(--primary));--link-active: var(--button-primary-bg-active);--link-hover: var(--button-primary-bg-hover);--main-color: var(--pr-orange);--background: var(--pr-white);--badge-new-bg: #ffedd5;--badge-new-text: #ad3100;--bento-media-gradient-end: #100;--bento-media-gradient-start: #f34f12;--border-radius-sm: 4px;--border-hover: #d1d1d1;--border-subtle: #e5e5e5;--button-focus-outline: #09090b;--button-ghost-bg-active: #e4e4e7;--button-ghost-bg-hover: #f4f4f5;--button-ghost-text: #18181b;--button-primary-bg: var(--main-color);--button-primary-bg-active: #a32e00;--button-primary-bg-hover: #be3600;--button-primary-text: #fff;--button-quaternary-bg: #fff;--button-quaternary-bg-active: #e4e4e7;--button-quaternary-bg-hover: #f4f4f5;--button-quaternary-text: #18181b;--button-secondary-bg: transparent;--button-secondary-bg-active: #fadcc0;--button-secondary-bg-hover: #ffedd5;--button-secondary-border: #ad3100;--button-secondary-text: #ad3100;--button-tertiary-bg: #fff2e1;--button-tertiary-bg-active: #fed7aa;--button-tertiary-bg-hover: #ffedd5;--button-tertiary-text: #ad3100;--capability-chip-bg: #f0f6ff;--capability-chip-border: #d8e6ff;--capability-chip-text: #002e99;--container-gutter-default: 16px;--container-gutter-lg: 32px;--container-max-2xl: 1360px;--foreground: #000;--logo-fallback-0-bg: #eff6ff;--logo-fallback-0-text: #1d4ed8;--logo-fallback-1-bg: #f0fdf4;--logo-fallback-1-text: #15803d;--logo-fallback-2-bg: #fffbeb;--logo-fallback-2-text: #b45309;--logo-fallback-3-bg: #faf5ff;--logo-fallback-3-text: #7e22ce;--logo-fallback-4-bg: #fff1f2;--logo-fallback-4-text: #be123c;--logo-fallback-5-bg: #ecfeff;--logo-fallback-5-text: #0e7490;--status-in-progress: #f0b400;--status-in-progress-bg: #fff4d1;--status-in-progress-text: #7e6612;--status-live: #2ba027;--status-live-bg: #dbf6da;--status-live-text: #207c40;--surface-1: #fff;--surface-2: #f5f5f5;--surface-warm: #f1f0ec;--tag-neutral-bg: #f6f7fa;--tag-neutral-border: #f0f2f6;--tag-neutral-text: #3f4d67;--text-muted: #404040;--text-soft: #666c79;--text-strong: #171717;--text-subtle: #9ca3af}html.dark{--accent: rgb(var(--primary-light));--link-active: #c96f28;--link-hover: #f0a266}"},{"filePath":"snippets/general/card.css","content":".pr-card-group{container-type:inline-size;display:grid;gap:var(--space-4, 16px);margin:var(--space-4, 16px) 0}.pr-card-group--cols-1{grid-template-columns:1fr}.pr-card-group--cols-2{grid-template-columns:repeat(2, minmax(0, 1fr))}.pr-card-group--cols-3{grid-template-columns:repeat(3, minmax(0, 1fr))}.pr-card-group--cols-4{grid-template-columns:repeat(4, minmax(0, 1fr))}@container (max-width: 620px){.pr-card-group--cols-3,.pr-card-group--cols-4{grid-template-columns:repeat(2, minmax(0, 1fr))}}@container (max-width: 340px){.pr-card-group{grid-template-columns:1fr}}.pr-card{display:flex;flex-direction:column;height:100%;overflow:hidden;border:1px solid #e5e5e5;border-radius:1rem;background-color:#fff;box-shadow:0 1px 2px 0 rgb(0 0 0 / 0.05);text-decoration:none;transition:transform 0.2s ease,\n background 0.2s ease,\n box-shadow 0.2s ease}.pr-card:hover{background-color:#f5f5f5;box-shadow:0 10px 15px -3px rgb(0 0 0 / 0.1),\n 0 4px 6px -4px rgb(0 0 0 / 0.1)}.pr-card__image{display:block;background-size:cover;width:100%;height:auto;aspect-ratio:16 / 9;margin:0;object-fit:cover;background-color:#f3f4f6}.pr-card__body{display:flex;flex-direction:column;gap:0.5rem;height:100%;padding:1.5rem}.pr-card__header{display:flex;align-items:center;gap:0.5rem}.pr-card__icon{display:flex;flex-shrink:0;align-items:center;justify-content:center;width:2.5rem;height:2.5rem;border-radius:1rem;background-color:rgb(var(--primary) / 0.1);color:var(--accent)}.pr-card__body:not(:first-child){border-top:1px solid #e5e5e5}.pr-card__title{margin:0;font-size:1.25rem;font-weight:600;line-height:1.25rem;color:var(--foreground)}.pr-card__text{margin:0;font-size:0.875rem;font-weight:400;line-height:1.5rem;color:var(--text-muted)}.dark .pr-card{border-color:#262626;background-color:#171717}.dark .pr-card:hover,.dark .pr-card__image{background-color:#262626}.dark .pr-card__body:not(:first-child){border-top-color:#404040}.dark .pr-card__icon{background-color:#262626}.dark .pr-card__title{color:#fff}.dark .pr-card__text{color:#f5f5f5}.pr-card.hover-zoom{transform:scale(1);\u0026:hover,\u0026:focus{transform:scale(1.05) translateY(-2%)}}@media (prefers-reduced-motion: reduce){.pr-card.hover-zoom{transform:none;\u0026:hover,\u0026:focus{transform:none}}}.provider-card{display:flex;align-items:center;gap:0.75rem;text-align:left}.provider-card-logo{display:block;width:2.5rem;height:2.5rem;flex-shrink:0;overflow:hidden;--tile-radius: 0.5rem;border-radius:var(--tile-radius)}.provider-card-logo img{width:100%;height:100%;margin:0;object-fit:contain}.provider-card-logo-fallback{display:flex;align-items:center;justify-content:center;width:100%;height:100%;background:var(--tag-neutral-bg);color:var(--tag-neutral-text);font-size:1.25rem;font-weight:600;line-height:1}.provider-card-name,.provider-card-type{margin:0}.provider-card-name{font-weight:600}.provider-card-type{font-size:0.875rem;line-height:1.25rem;color:rgb(var(--gray-500))}.dark .provider-card-type{color:rgb(var(--gray-400))}"},{"filePath":"snippets/payment-methods/explorer.css","content":".payment-methods-explorer:empty{min-height:3000px}.payment-method-logo{display:inline-flex;width:28px;height:28px;flex-shrink:0;overflow:hidden;--tile-radius: 0.375rem;border-radius:var(--tile-radius)}.payment-method-logo img{width:100%;height:100%;margin:0;object-fit:contain}"},{"filePath":"snippets/integrations/filterable-list.css","content":".integrations-filter{container-type:inline-size}.integrations-filter:empty::before{content:\"\";display:block;height:184px}@container (min-width: 310px){.integrations-filter:empty::before{height:140px}}@container (min-width: 364px){.integrations-filter:empty::before{height:96px}}@container (min-width: 665px){.integrations-filter:empty::before{height:52px}}.integration-card{display:flex;flex-direction:column}.integration-card>.card{flex:1}.integration-card[hidden]{display:none!important}"}],"page":{"pagePath":"docs/token-vault","slug":"/docs/token-vault","pageMetadata":{"title":"Token Vault","sidebarTitle":"Overview","description":"In this section, you will learn how to use Vault as a standalone module, about our proxies, tokenization and detokenization methods.","href":"/docs/token-vault"},"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: \"In this section, you will learn how to use Vault as a standalone module, about our proxies, tokenization and detokenization methods.\"\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`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,OptimizedImage}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`introduction`,children:`Introduction`}),`\n`,_jsxs(_components.p,{children:[`If you have read our `,_jsx(_components.a,{href:`/docs/overview/vault`,children:`Token Vault introduction`}),` page, you already know that Payrails offers multiple ways to use our Token Vault, as a standalone module or within the Payment Orchestration with Payrails. In this section, we introduce the Vault module. If you are not sure how you want to use the vault, you can navigate to the next `,_jsx(_components.a,{href:`#options-to-use-payrails-token-vault`,children:`section`}),` to learn your options.`]}),`\n`,_jsx(Heading,{level:`2`,id:`benefits`,children:`Benefits`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Payrails Vault is a `,_jsx(_components.strong,{children:`PCI-DSS Level 1 compliant`}),` vault, which you can use to minimize your PCI scope.`]}),`\n`,_jsxs(_components.li,{children:[`It is provider-agnostic that allows you to `,_jsx(_components.strong,{children:`switch between any payment service providers`}),` at any time, without disrupting your customer experience or facing technical hurdles. Because your token vault is independent of any single payment processor, you’re not locked into any one provider — this means you can take advantage of `,_jsx(_components.strong,{children:`better rates, improved service, or new features`}),` from other providers at any time.`]}),`\n`,_jsxs(_components.li,{children:[`Payrails Vault enables you to securely receive and send tokenized data to `,_jsx(_components.strong,{children:`a variety of third-party services — not just PSPs`}),` — without exposing sensitive information to your systems. Whether it’s fraud prevention tools, online travel agencies, channel managers, property management systems, loyalty platforms, other external token vaults, or internal systems, you can configure proxy connections to route sensitive data securely and stay out of PCI scope.`]}),`\n`,_jsxs(_components.li,{children:[`With Vault, your returning customers can use stored payment methods for a `,_jsx(_components.strong,{children:`smoother checkout experience`}),`, use tokenized payment methods, which are the `,_jsx(_components.strong,{children:`best performing in subscription`}),` or recurring payment scenarios (particularly when used with network tokens), and `,_jsx(_components.strong,{children:`enable users to manage`}),` their saved cards and have control over their sensitive information.`]}),`\n`,_jsxs(_components.li,{children:[`You can unlock more benefits with additional Vault features, such as network tokenization, card lifecycle updates and BIN lookup data. You will find more information about each feature as you navigate to the next pages of the `,_jsx(_components.strong,{children:`Token Vault`}),` section.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`options-to-use-payrails-token-vault`,children:`Options to use Payrails Token Vault`}),`\n`,_jsx(_components.p,{children:`There are 2 main alternatives to use Payrails Token Vault:`}),`\n`,_jsx(OptimizedImage,{className:`mint-float-right mint-ml-4 mint-mb-1 mint-mt-0 mint-rounded-lg mint-object-cover`,src:`https://mintcdn.com/payrails-42074109/knNnlxc2J__TB9tW/images/docs/token-vault/getting-started-1.png?fit=max\u0026auto=format\u0026n=knNnlxc2J__TB9tW\u0026q=85\u0026s=0c8bfc0bd0f4d36aa47baeb525cb6e07`,width:`100%`,alt:`Diagram: the merchant sends sensitive data through Payrails Vault to its integrations, and other data straight to them`,\"data-og-width\":`1190`,\"data-og-height\":`556`,\"data-path\":`images/docs/token-vault/getting-started-1.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/payrails-42074109/knNnlxc2J__TB9tW/images/docs/token-vault/getting-started-1.png?w=280\u0026fit=max\u0026auto=format\u0026n=knNnlxc2J__TB9tW\u0026q=85\u0026s=8b2468404eacefcbca0ef46e1afd42fb 280w, https://mintcdn.com/payrails-42074109/knNnlxc2J__TB9tW/images/docs/token-vault/getting-started-1.png?w=560\u0026fit=max\u0026auto=format\u0026n=knNnlxc2J__TB9tW\u0026q=85\u0026s=164c6e8a9ab5764fb60b2f5247556dd8 560w, https://mintcdn.com/payrails-42074109/knNnlxc2J__TB9tW/images/docs/token-vault/getting-started-1.png?w=840\u0026fit=max\u0026auto=format\u0026n=knNnlxc2J__TB9tW\u0026q=85\u0026s=0f87c5ce80647d8633d7637544b187f0 840w, https://mintcdn.com/payrails-42074109/knNnlxc2J__TB9tW/images/docs/token-vault/getting-started-1.png?w=1100\u0026fit=max\u0026auto=format\u0026n=knNnlxc2J__TB9tW\u0026q=85\u0026s=bcc250a79d13e87e8be77ea7c721475d 1100w, https://mintcdn.com/payrails-42074109/knNnlxc2J__TB9tW/images/docs/token-vault/getting-started-1.png?w=1650\u0026fit=max\u0026auto=format\u0026n=knNnlxc2J__TB9tW\u0026q=85\u0026s=245d9731eb3a717daf6d0fde7c626c30 1650w, https://mintcdn.com/payrails-42074109/knNnlxc2J__TB9tW/images/docs/token-vault/getting-started-1.png?w=2500\u0026fit=max\u0026auto=format\u0026n=knNnlxc2J__TB9tW\u0026q=85\u0026s=242f362375a7d64f1c15de1d3a6dd0f0 2500w`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`1. Token Vault as a standalone module:`})}),`\n`,_jsxs(_components.p,{children:[`In the case that you want to manage third-party integrations within your system, such as payment providers or your travel partners, but only use our Vault for the storage and processing of the sensitive data, you can use our Vault as a `,_jsx(_components.strong,{children:`proxy`}),` which collects the sensitive data via our SDKs and pass the sensitive information to third parties without touching the sensitive data.`]}),`\n`,_jsx(OptimizedImage,{className:`mint-float-right mint-ml-4 mint-mb-1 mint-mt-0 mint-rounded-lg mint-object-cover`,src:`https://mintcdn.com/payrails-42074109/knNnlxc2J__TB9tW/images/docs/token-vault/getting-started-2.png?fit=max\u0026auto=format\u0026n=knNnlxc2J__TB9tW\u0026q=85\u0026s=515a9a53e5833b735e0c77c3904dc25d`,width:`100%`,alt:`Diagram: the merchant connects to Payrails Vault and Payrails Orchestration, which route to Payrails integrations`,\"data-og-width\":`1188`,\"data-og-height\":`562`,\"data-path\":`images/docs/token-vault/getting-started-2.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/payrails-42074109/knNnlxc2J__TB9tW/images/docs/token-vault/getting-started-2.png?w=280\u0026fit=max\u0026auto=format\u0026n=knNnlxc2J__TB9tW\u0026q=85\u0026s=b229856f6b0a9aa307c838d675bddb49 280w, https://mintcdn.com/payrails-42074109/knNnlxc2J__TB9tW/images/docs/token-vault/getting-started-2.png?w=560\u0026fit=max\u0026auto=format\u0026n=knNnlxc2J__TB9tW\u0026q=85\u0026s=0f70164a0c9f0714f57e1589c5fd9823 560w, https://mintcdn.com/payrails-42074109/knNnlxc2J__TB9tW/images/docs/token-vault/getting-started-2.png?w=840\u0026fit=max\u0026auto=format\u0026n=knNnlxc2J__TB9tW\u0026q=85\u0026s=8017f3c2414aa5b6c5fea11f0a9e85a6 840w, https://mintcdn.com/payrails-42074109/knNnlxc2J__TB9tW/images/docs/token-vault/getting-started-2.png?w=1100\u0026fit=max\u0026auto=format\u0026n=knNnlxc2J__TB9tW\u0026q=85\u0026s=84cffdc5f8dd8b18b1fbefa52d7279c8 1100w, https://mintcdn.com/payrails-42074109/knNnlxc2J__TB9tW/images/docs/token-vault/getting-started-2.png?w=1650\u0026fit=max\u0026auto=format\u0026n=knNnlxc2J__TB9tW\u0026q=85\u0026s=c8de8eea1ba42089456395f34396a073 1650w, https://mintcdn.com/payrails-42074109/knNnlxc2J__TB9tW/images/docs/token-vault/getting-started-2.png?w=2500\u0026fit=max\u0026auto=format\u0026n=knNnlxc2J__TB9tW\u0026q=85\u0026s=07abe18761c6cbf9614c46d0ecedcb8f 2500w`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`2. Token Vault as part of payment orchestration:`})}),`\n`,_jsx(_components.p,{children:`In the case that you want one single API integration with Payrails payment orchestration platform, which in the background, will connect you to all the provider integrations for you in a PSP-agnostic way using our Vault.`}),`\n`,_jsx(Heading,{level:`3`,id:`using-token-vault-with-combination-of-other-payrails-modules`,children:`Using Token Vault with combination of other Payrails modules`}),`\n`,_jsx(_components.p,{children:`If you start using our Vault as a standalone module, you can always start using our other modules later, such as payment orchestration or analytics, at any moment in time. It is also possible to use both integration methods at the same time if your business needs require that.`})]})}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":"Token Vault","sidebarTitle":"Overview","description":"In this section, you will learn how to use Vault as a standalone module, about our proxies, tokenization and detokenization methods.","href":"/docs/token-vault"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Introduction","slug":"introduction","depth":2,"children":[]},{"title":"Benefits","slug":"benefits","depth":2,"children":[]},{"title":"Options to use Payrails Token Vault","slug":"options-to-use-payrails-token-vault","depth":2,"children":[{"title":"Using Token Vault with combination of other Payrails modules","slug":"using-token-vault-with-combination-of-other-payrails-modules","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/payrails-42074109/138fc948c6832630/consent.js","/_mintlify/custom/payrails-42074109/6a6f8c8ba4227cb9/same-tab-links.js","/_mintlify/custom/payrails-42074109/6e438b650fe2798f/noindex-other-hosts.js"],"dynamicCss":".mint-float-right {\n float: right\n}\n.mint-mb-1 {\n margin-bottom: 0.25rem\n}\n.mint-ml-4 {\n margin-left: 1rem\n}\n.mint-mt-0 {\n margin-top: 0px\n}\n.mint-rounded-lg {\n border-radius: 0.5rem\n}\n.mint-object-cover {\n object-fit: cover\n}","subdomain":"payrails-42074109","siteName":"Payrails Docs","title":"Token Vault - Payrails Docs","relatedPagesConfig":{"enabled":true,"limit":3,"mode":"automatic"},"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-13T11:06:16.121Z","gitLastModified":"2026-11-13T11:05:57.000Z","originalFileLocation":"docs/token-vault.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=\"light\"}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=\"In this section, you will learn how to use Vault as a standalone module, about our proxies, tokenization and detokenization methods.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Payrails Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/payrails-42074109/xPEGo5yZy52JZSmG/_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/payrails-42074109/xPEGo5yZy52JZSmG/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/payrails-42074109/xPEGo5yZy52JZSmG/_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/payrails-42074109/xPEGo5yZy52JZSmG/_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/payrails-42074109/xPEGo5yZy52JZSmG/_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/payrails-42074109/xPEGo5yZy52JZSmG/_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/payrails-42074109/xPEGo5yZy52JZSmG/_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/payrails-42074109/xPEGo5yZy52JZSmG/_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/payrails-42074109/xPEGo5yZy52JZSmG/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Token Vault - Payrails Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"In this section, you will learn how to use Vault as a standalone module, about our proxies, tokenization and detokenization methods.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Payrails Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.payrails.com/docs/token-vault\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://payrails-42074109.mintlify.site/_mintlify/api/og/v2?division=Token+Vault\u0026amp;title=Token+Vault\u0026amp;description=In+this+section%2C+you+will+learn+how+to+use+Vault+as+a+standalone+module%2C+about+our+proxies%2C+tokenization+and+detokenization+methods.\u0026amp;theme=fc36d2d43704e46c9451c8d9\u0026amp;signature=a3f2558fb9699d86607045a5f4a0a510cf286e9626ee4f38db0ebe3cbe9e752d\">\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=\"Token Vault - Payrails Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"In this section, you will learn how to use Vault as a standalone module, about our proxies, tokenization and detokenization methods.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://payrails-42074109.mintlify.site/_mintlify/api/og/v2?division=Token+Vault\u0026amp;title=Token+Vault\u0026amp;description=In+this+section%2C+you+will+learn+how+to+use+Vault+as+a+standalone+module%2C+about+our+proxies%2C+tokenization+and+detokenization+methods.\u0026amp;theme=fc36d2d43704e46c9451c8d9\u0026amp;signature=a3f2558fb9699d86607045a5f4a0a510cf286e9626ee4f38db0ebe3cbe9e752d\">\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/payrails-42074109/xPEGo5yZy52JZSmG/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Payrails Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#D63D00\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003cmeta data-mint-head name=\"msvalidate.01\" content=\"7723ABF900EAD08F0500790E9BFC62E7\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.payrails.com/docs/token-vault\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/token-vault.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.payrails.com#organization\",\"name\":\"Payrails\",\"legalName\":\"Payrails GmbH\",\"url\":\"https://www.payrails.com/\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://www.payrails.com/payrails-logo.svg\"},\"sameAs\":[\"https://www.linkedin.com/company/payrails/\",\"https://www.crunchbase.com/organization/payrails\",\"https://www.wikidata.org/wiki/Q137211152\",\"https://x.com/Payrails_com\"]},{\"@type\":\"WebSite\",\"@id\":\"https://docs.payrails.com#website\",\"name\":\"Payrails Docs\",\"url\":\"https://docs.payrails.com\",\"publisher\":{\"@id\":\"https://www.payrails.com#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.payrails.com/docs/token-vault#webpage\",\"url\":\"https://docs.payrails.com/docs/token-vault\",\"name\":\"Token Vault\",\"description\":\"In this section, you will learn how to use Vault as a standalone module, about our proxies, tokenization and detokenization methods.\",\"dateModified\":\"2026-11-13T11:05:57.000Z\",\"isPartOf\":{\"@id\":\"https://docs.payrails.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.payrails.com/docs/token-vault#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.payrails.com/docs/token-vault#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Payrails Docs\",\"item\":\"https://docs.payrails.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Token Vault\",\"item\":\"https://docs.payrails.com/docs/token-vault\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.payrails.com/docs/token-vault#article\",\"headline\":\"Token Vault\",\"name\":\"Token Vault\",\"description\":\"In this section, you will learn how to use Vault as a standalone module, about our proxies, tokenization and detokenization methods.\",\"url\":\"https://docs.payrails.com/docs/token-vault\",\"mainEntityOfPage\":{\"@id\":\"https://docs.payrails.com/docs/token-vault#webpage\"},\"dateModified\":\"2026-11-13T11:05:57.000Z\",\"publisher\":{\"@id\":\"https://www.payrails.com#organization\"},\"isPartOf\":{\"@id\":\"https://docs.payrails.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Payrails Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Payrails\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/token-vault.md","siteName":"Payrails Docs","nav":{"global":{"anchors":[]},"tabs":[{"tab":"Home","pages":[{"title":"Home","href":""}]},{"tab":"Guides","groups":[{"group":"Getting Started","icon":"https://mintlify.s3.us-west-1.amazonaws.com/payrails-42074109/images/icons/nav/rocket_launch.svg","pages":[{"title":"Explore Payrails","href":"/docs/explore-payrails"},{"group":"Core concepts","pages":[{"title":"How Payrails works","sidebarTitle":"Overview","href":"/docs/overview"},{"title":"Workflows","href":"/docs/overview/workflows"},{"title":"Checkout","href":"/docs/overview/checkout"},{"title":"Dynamic Routing","href":"/docs/overview/routing"},{"title":"Routing configuration","hidden":true,"href":"/docs/overview/routing-configuration"},{"title":"Payment Options","href":"/docs/overview/payment-options"},{"title":"Token Vault","href":"/docs/overview/vault"}]},{"group":"Account setup","pages":[{"title":"Set up your Payrails account and environment","sidebarTitle":"Overview","deprecated":false,"hidden":false,"href":"/docs/account-setup"},{"title":"API Credentials","href":"/docs/account-setup/api-credentials"},{"title":"mTLS Configuration","href":"/docs/account-setup/mtls-configuration"},{"group":"User Management","pages":[{"title":"User Management","sidebarTitle":"Overview","href":"/docs/account-setup/user-management"},{"title":"Authentication","href":"/docs/account-setup/user-management/authentication"},{"title":"Roles \u0026 Permissions","href":"/docs/account-setup/user-management/roles-permissions"},{"title":"Frequently Asked Questions","href":"/docs/account-setup/user-management/frequently-asked-questions"},{"title":"Single Sign-On","href":"/docs/account-setup/user-management/single-sign-on"}]},{"title":"Organization","href":"/docs/account-setup/organization"},{"title":"Workspaces","href":"/docs/account-setup/workspaces"},{"title":"Idempotent Requests","href":"/docs/account-setup/idempotent-requests"}]}]},{"group":"Payment Orchestration","icon":"https://mintlify.s3.us-west-1.amazonaws.com/payrails-42074109/images/icons/nav/account_tree.svg","pages":[{"title":"Payment Orchestration","sidebarTitle":"Overview","href":"/docs/orchestration"},{"title":"Accept payments via API","href":"/docs/orchestration/accept-payments-via-api"},{"group":"Meta fields","pages":[{"title":"Meta fields","sidebarTitle":"Overview","href":"/docs/orchestration/meta-fields"},{"title":"Order costs","href":"/docs/orchestration/meta-fields/order-costs"}]},{"group":"Payment Acceptance","pages":[{"title":"Create a workflow execution","href":"/docs/orchestration/payment-acceptance/create-a-workflow-execution"},{"title":"Lookup payment options","href":"/docs/orchestration/payment-acceptance/lookup-payment-options"},{"title":"Authorize a payment","href":"/docs/orchestration/payment-acceptance/authorize-a-payment"},{"title":"Capture a payment","href":"/docs/orchestration/payment-acceptance/capture-a-payment"},{"title":"Capture and cancel modes","href":"/docs/orchestration/payment-acceptance/capture-and-cancel-modes"},{"title":"Cancel a payment","href":"/docs/orchestration/payment-acceptance/cancel-a-payment"},{"title":"Refund a payment","href":"/docs/orchestration/payment-acceptance/refund-a-payment"},{"title":"Test payments","href":"/docs/orchestration/payment-acceptance/test-payments"},{"title":"Receive notifications","href":"/docs/orchestration/payment-acceptance/receive-notifications"},{"title":"3D Secure","href":"/docs/orchestration/payment-acceptance/3d-secure"}]},{"title":"Autopilot","href":"/docs/orchestration/autopilot"},{"group":"Workflow Studio","pages":[{"title":"Workflow Studio","sidebarTitle":"Overview","href":"/docs/orchestration/workflow-studio"},{"title":"Quick Start Guide","sidebarTitle":"Quick start","href":"/docs/orchestration/workflow-studio/quick-start"},{"title":"Triggers","href":"/docs/orchestration/workflow-studio/triggers"},{"title":"Actions","href":"/docs/orchestration/workflow-studio/actions"},{"title":"Cancel and Capture Modes","hidden":true,"href":"/docs/orchestration/workflow-studio/cancel-and-capture-mode"},{"title":"Conditions and Branching","sidebarTitle":"Conditions","href":"/docs/orchestration/workflow-studio/conditions"},{"title":"Monitoring Workflow Executions","sidebarTitle":"Monitoring","href":"/docs/orchestration/workflow-studio/monitoring"},{"group":"Examples","pages":[{"title":"Workflow Examples","sidebarTitle":"Overview","href":"/docs/orchestration/workflow-studio/examples"},{"title":"Simple Authorization","href":"/docs/orchestration/workflow-studio/examples/simple-authorization"},{"title":"Authorization with Fraud Screening","href":"/docs/orchestration/workflow-studio/examples/authorization-with-fraud"},{"title":"Authorization with 3D Secure","href":"/docs/orchestration/workflow-studio/examples/authorization-with-3ds"},{"title":"Full Authorization with Fraud and 3DS","href":"/docs/orchestration/workflow-studio/examples/full-authorization"},{"title":"Capture with Fraud Update","href":"/docs/orchestration/workflow-studio/examples/capture-with-fraud-update"},{"title":"Conditional Refund","href":"/docs/orchestration/workflow-studio/examples/conditional-refund"},{"title":"Event-Driven Auto-Capture","href":"/docs/orchestration/workflow-studio/examples/event-driven-auto-capture"},{"title":"Provider Routing with Conditions","href":"/docs/orchestration/workflow-studio/examples/provider-routing"}]},{"group":"Reference","pages":[{"title":"Condition Operators Reference","sidebarTitle":"Condition operators","href":"/docs/orchestration/workflow-studio/conditions/operators"},{"title":"Status Codes Reference","sidebarTitle":"Status codes","href":"/docs/orchestration/workflow-studio/monitoring/status-codes"},{"title":"Glossary","href":"/docs/orchestration/workflow-studio/glossary"}]}]},{"title":"In-person payments","href":"/docs/orchestration/in-person"},{"group":"Payment Links","pages":[{"title":"Payment Links","sidebarTitle":"Overview","href":"/docs/orchestration/payment-links"},{"title":"Create a payment link","href":"/docs/orchestration/payment-links/create-a-payment-link"},{"title":"How it works","href":"/docs/orchestration/payment-links/how-it-works"},{"title":"Payment modes","href":"/docs/orchestration/payment-links/payment-modes"},{"title":"Share the link","href":"/docs/orchestration/payment-links/share-the-link"},{"title":"Track and reconcile","href":"/docs/orchestration/payment-links/track-and-reconcile"}]}]},{"group":"Merchant of Record","icon":"https://mintlify.s3.us-west-1.amazonaws.com/payrails-42074109/images/icons/nav/storefront.svg","pages":[{"title":"Merchant of Record","sidebarTitle":"Overview","description":"Accept payments with Payrails as the legal seller — tax calculation, invoicing, and a compliant checkout surface rendered by the drop-in.","href":"/docs/merchant-of-record"}]},{"group":"Token Vault","icon":"https://mintlify.s3.us-west-1.amazonaws.com/payrails-42074109/images/icons/nav/credit_card.svg","pages":[{"title":"Token Vault","sidebarTitle":"Overview","href":"/docs/token-vault"},{"title":"Records, Aliases and Instruments","sidebarTitle":"Records and aliases","description":"Learn how the Payrails vault stores sensitive data as records, aliases, and instruments, and how retention policies apply to security codes.","href":"/docs/token-vault/tokenize-records"},{"title":"Direct Vault API","href":"/docs/token-vault/direct-vault-api"},{"group":"Tokenize cards via SDK","pages":[{"title":"Tokenize Cards via SDK","sidebarTitle":"Overview","href":"/docs/token-vault/tokenize-payment-instruments"},{"title":"Tokenize cards with Secure Fields","href":"/docs/token-vault/tokenize-payment-instruments/tokenize-cards-with-secure-fields"},{"title":"Tokenize cards with Client-side Encryption","href":"/docs/token-vault/tokenize-payment-instruments/tokenize-cards-with-client-side-encryption"},{"title":"Tokenize cards with API-only","href":"/docs/token-vault/tokenize-payment-instruments/tokenize-cards-with-api-only"}]},{"group":"Display cards via SDK","pages":[{"title":"Display Cards via SDK","sidebarTitle":"Overview","href":"/docs/token-vault/display-sdk"},{"title":"Dynamic Styling Based on BIN","sidebarTitle":"Dynamic styling by BIN","href":"/docs/token-vault/display-sdk/dynamic-styling-based-on-bin"}]},{"group":"Vault Proxy","pages":[{"title":"Vault Proxy","sidebarTitle":"Overview","href":"/docs/token-vault/vault-proxy"},{"group":"Instant Proxy","pages":[{"title":"Instant Proxy","sidebarTitle":"Overview","href":"/docs/token-vault/vault-proxy/proxy-payment-instruments"},{"title":"Cards via Proxy","href":"/docs/token-vault/vault-proxy/proxy-payment-instruments/cards-via-proxy"},{"title":"Apple Pay via Proxy","href":"/docs/token-vault/vault-proxy/proxy-payment-instruments/apple-pay-via-proxy"},{"title":"Google Pay via Proxy","href":"/docs/token-vault/vault-proxy/proxy-payment-instruments/google-pay-via-proxy"}]},{"group":"Configurable Proxy","pages":[{"title":"Configurable Proxy","sidebarTitle":"Overview","href":"/docs/token-vault/vault-proxy/proxy-connections"},{"title":"Managing Connections","href":"/docs/token-vault/vault-proxy/proxy-connections/managing-connections"},{"title":"Invoking Connections","href":"/docs/token-vault/vault-proxy/proxy-connections/invoking-connections"}]}]},{"group":"Network tokens","pages":[{"title":"Network Tokens","sidebarTitle":"Overview","href":"/docs/token-vault/network-tokens"},{"title":"Onboarding to Networks","href":"/docs/token-vault/network-tokens/onboarding-to-networks"},{"title":"Provision Network Tokens","href":"/docs/token-vault/network-tokens/provision-network-tokens"},{"title":"Transacting with Network Tokens","href":"/docs/token-vault/network-tokens/transacting-with-network-tokens"},{"title":"Automatic Lifecycle Updates","href":"/docs/token-vault/network-tokens/automatic-lifecycle-updates"}]},{"group":"Token migration","pages":[{"title":"Token Migration","sidebarTitle":"Overview","href":"/docs/token-vault/token-migration"},{"title":"Self-served migration of card data from PSPs","sidebarTitle":"Self-serve migration","href":"/docs/token-vault/token-migration/self-serve-migration"}]},{"title":"Frequently Asked Questions","sidebarTitle":"FAQ","href":"/docs/token-vault/frequently-asked-questions"}]},{"group":"Analytics \u0026 Reporting","icon":"https://mintlify.s3.us-west-1.amazonaws.com/payrails-42074109/images/icons/nav/show_chart.svg","pages":[{"title":"Analytics \u0026 Reporting","sidebarTitle":"Overview","href":"/docs/analytics-and-reporting"},{"group":"Upload files","pages":[{"title":"Upload files","sidebarTitle":"Overview","href":"/docs/analytics-and-reporting/upload-files"},{"title":"Orders Report","sidebarTitle":"Orders report","href":"/docs/analytics-and-reporting/upload-files/orders-report"}]},{"group":"Reports","pages":[{"title":"Reports","sidebarTitle":"Overview","href":"/docs/analytics-and-reporting/reports"},{"title":"Payments report","href":"/docs/analytics-and-reporting/reports/payments"},{"title":"Settlements report","href":"/docs/analytics-and-reporting/reports/settlements"},{"title":"Transactions report","href":"/docs/analytics-and-reporting/reports/transactions"},{"title":"Disputes report","href":"/docs/analytics-and-reporting/reports/disputes"}]},{"title":"Unified Analytics","href":"/docs/analytics-and-reporting/unified-analytics"},{"title":"Dashboards","href":"/docs/analytics-and-reporting/dashboards"}]},{"group":"Fraud Management","icon":"https://mintlify.s3.us-west-1.amazonaws.com/payrails-42074109/images/icons/nav/shield_person.svg","pages":[{"title":"Fraud Score","href":"/docs/fraud-management/fraud-score"}]},{"group":"Chargebacks","icon":"https://mintlify.s3.us-west-1.amazonaws.com/payrails-42074109/images/icons/nav/warning.svg","pages":[{"title":"Chargebacks","sidebarTitle":"Overview","href":"/docs/chargebacks"}]},{"group":"Monitoring","icon":"https://mintlify.s3.us-west-1.amazonaws.com/payrails-42074109/images/icons/nav/notifications.svg","pages":[{"title":"Alerts","href":"/docs/monitoring/configure-alerts"}]},{"group":"Resources","icon":"https://mintlify.s3.us-west-1.amazonaws.com/payrails-42074109/images/icons/nav/menu_book.svg","pages":[{"group":"Payments","pages":[{"title":"Payments","sidebarTitle":"Overview","href":"/docs/resources/payments"},{"title":"Payment Status","href":"/docs/resources/payments/payment-status"},{"title":"Operation Types","href":"/docs/resources/payments/operation-types"},{"title":"Operation Results","href":"/docs/resources/payments/operation-results"},{"title":"Authorization flags","href":"/docs/resources/payments/authorization-flags"}]},{"title":"Executions","href":"/docs/resources/executions"},{"group":"Notifications","pages":[{"title":"Notifications","sidebarTitle":"Overview","hidden":false,"href":"/docs/resources/notifications"},{"title":"Action updated notifications","href":"/docs/resources/notifications/action-updated-notifications"},{"title":"Dispute notifications","href":"/docs/resources/notifications/dispute-notifications"},{"title":"Dispute alert notifications","href":"/docs/resources/notifications/dispute-alert-notifications"}]},{"title":"Holders","href":"/docs/resources/holder"},{"title":"Payment Instruments and Tokens","sidebarTitle":"Instruments and tokens","href":"/docs/resources/manage-instruments"},{"title":"Error codes","href":"/docs/resources/error-codes"},{"title":"Currency codes","href":"/docs/resources/currency-codes"}]},{"group":"Use Cases","icon":"https://mintlify.s3.us-west-1.amazonaws.com/payrails-42074109/images/icons/nav/lightbulb.svg","pages":[{"title":"Billing","href":"/docs/use-cases/billing-use-cases"},{"title":"Server-to-server Integration","href":"/docs/use-cases/server-to-server-integration-reference-architecture"}]}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/docs/integrations"}]},{"tab":"SDKs","pages":[{"title":"SDKs","href":"/docs/sdks"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/reference"}]}]},"basePath":"","title":"Token Vault - Payrails Docs","buildId":"dpl_5tKr6cUUeuVJdEZ9JAEY3h4soMJ8","deploymentId":"dpl_5tKr6cUUeuVJdEZ9JAEY3h4soMJ8","dynamics":["a74be98ba7"],"chunks":["zoom-image-lightbox-9bQKnClW.js","lightbox-handle-r17bVUz3.js"]}