How to use scheme tokens with or without payment orchestration
To process payments with network tokens you can choose between either of the following options.
Our automatic provisioning of tokens for use with our orchestration platform.
Our standalone tokenization endpoints for using the network tokens directly with the PSPs.
Before you start processing payments with network tokens, make sure you have
enabled processing with network tokens. Please contact the support team to get set up.
Although network tokens are agnostic tokens, not every payment service or acquirer support
the usage of network tokens that were provisioned outside of their own environment.When you use our system to orchestrate your payment, we will optimize the routing
behavior to take into consideration the limitations of the payment services you’re connecting to.
A payment service that supports externally obtained data is generally considered an open loop connection,
while one that doesn’t is considered closed loop.In our orchestration platform, we can support network tokens across any open-loop
payment services. You don’t have to perform any additional integrations to use network
tokens besides storing the original card data (PAN) in our Cloud Vault.
You can follow the regular flow of card integrations, and we will automatically swap out
the original card details with the network token when possible.For each first time use of the token a cryptogram is provisioned. Subsequent merchant initiated
transactions (MIT) will not need a cryptogram (these are optional), unless the transaction is done
with a newly provisioned token. For example if you have migrated an already running billing
sequence for a card to our systems and for these cards you’re provisioning tokens for the first time,
the first transaction done with that token will have a cryptogram provisioned automatically by mattilda Pay.
The token and cryptogram will be provisioned as “on file” and therefore the buyer does not have
to be present for the provisioning of either the token or the cryptogram.We have optimized the usage of network tokens by implementing scheme best practices
regarding cryptogram usage, as well as the correct payment flagging towards the payment services.
Using Flow, it will be possible to choose the instrument (PAN or Network token) in your
routing rules, allowing you to optimize your routing behavior.For best practices and advice on routing optimizations, please reach out to our support team.
Our API allows you to provision network tokens and cryptograms for use in your own system.
Please note that network tokens can be considered PCI sensitive data depending on your
interpretation of PCI guidelines, and therefore these API’s are not enabled in production by default.You can use the network token endpoints to obtain network tokens and their cryptograms
for use in your own system.
Network token provisioning via the API is not enabled by default in production.
Please contact support for further guidance.
{"docsConfig":{"theme":"palm","$schema":"https://mintlify.com/docs.json","name":"mattilda Pay","colors":{"primary":"#0069ED","light":"#4D9CFF","dark":"#0050B4"},"logo":{"light":"https://mintcdn.com/mattilda/yVMPq-_dro0vSEiX/assets/logos/light.svg?fit=max\u0026auto=format\u0026n=yVMPq-_dro0vSEiX\u0026q=85\u0026s=ebe404856efad414fe0e5816e122fbf3","dark":"https://mintcdn.com/mattilda/yVMPq-_dro0vSEiX/assets/logos/dark.svg?fit=max\u0026auto=format\u0026n=yVMPq-_dro0vSEiX\u0026q=85\u0026s=5064d58e92f6cf9e1b73945b8043e745"},"favicon":"https://mintcdn.com/mattilda/NYRslQ0epuL-JaEH/assets/favicon.png?fit=max\u0026auto=format\u0026n=NYRslQ0epuL-JaEH\u0026q=85\u0026s=0b246d2ab24fa7d49ab657027a1a4bf8","api":{"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["csharp","go","java","php","python","typescript"]},"mdx":{"auth":{"method":"bearer"},"server":["https://api.sandbox.mattildapayments.com","https://api.mattildapayments.com"]}},"navbar":{"links":[{"icon":"github","href":"https://github.com/gr4vy","label":"GitHub"}],"primary":{"type":"button","label":"mattilda Pay","href":"https://mattildapay.com"}},"footer":{"socials":{"website":"https://mattildapay.com","github":"https://github.com/gr4vy","linkedin":"https://www.linkedin.com/company/mattilda.io"}},"styling":{"eyebrows":"breadcrumbs","codeblocks":"dark","latex":true},"integrations":{"intercom":{"appId":"bp5sj6z7"}},"contextual":{"options":["chatgpt","claude","copy","view"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"mattilda","hasAudioNarration":false,"actualSubdomain":"mattilda","customDomains":["docs.mattildapayments.com"],"gitSource":{"type":"github","owner":"mattilda-education","repo":"gr4vy-docs-mintlify","deployBranch":"mattilda_pay","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ad7fc40b86df1a05c8ecc42","collectionId":"46b32a21-1651-4bba-87de-5045c78e185e","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad7fc40b86df1a05c8ecc42"},"feedback":{"thumbs":true,"edits":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6ad7fc40b86df1a05c8ecc42","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"default","tag":"Payments","count":133},{"language":"default","tag":"API Reference","count":80},{"language":"default","tag":"Integration","count":69},{"language":"default","tag":"Features","count":47},{"language":"default","tag":"Quick start","count":32},{"language":"default","tag":"Vault","count":18},{"language":"default","tag":"E-commerce Plugins","count":15},{"language":"default","tag":"Embed","count":13},{"language":"default","tag":"Other","count":12},{"language":"default","tag":"Network tokens","count":11}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"sso-setup-deadline-banner","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}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".payment-service-definition{background-color:#fff!important;border:1px solid #0a0e0d1a;border-radius:16px;padding:2em;vertical-align:middle}.payment-service-definition img{margin:0 1em 0 0;max-width:3em;display:inline-block}.payment-service-definition h2{margin:0;display:inline-block;position:relative;top:.1em}"}],"page":{"pagePath":"guides/features/network-tokens/implementation","slug":"/guides/features/network-tokens/implementation","pageMetadata":{"title":"Network token implementation","sidebarTitle":"Implementation","description":"How to use scheme tokens with or without payment orchestration","href":"/guides/features/network-tokens/implementation"},"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: \"How to use scheme tokens with or without payment orchestration\"\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,Info,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`To process payments with network tokens you can choose between either of the following options.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Our `,_jsx(_components.strong,{children:`automatic provisioning of tokens`}),` for use with our orchestration platform.`]}),`\n`,_jsxs(_components.li,{children:[`Our `,_jsx(_components.strong,{children:`standalone tokenization endpoints`}),` for using the network tokens directly with the PSPs.`]}),`\n`]}),`\n`,_jsx(Info,{children:_jsx(_components.p,{children:`Before you start processing payments with network tokens, make sure you have\nenabled processing with network tokens. Please contact the support team to get set up.`})}),`\n`,_jsx(Heading,{level:`2`,id:`automatic-provisioning-of-network-tokens`,children:`Automatic provisioning of network tokens`}),`\n`,_jsx(_components.p,{children:`Although network tokens are agnostic tokens, not every payment service or acquirer support\nthe usage of network tokens that were provisioned outside of their own environment.`}),`\n`,_jsxs(_components.p,{children:[`When you use our system to orchestrate your payment, we will optimize the routing\nbehavior to take into consideration the limitations of the payment services you’re connecting to.\nA payment service that supports externally obtained data is generally considered an `,_jsx(_components.strong,{children:`open loop connection`}),`,\nwhile one that doesn’t is considered `,_jsx(_components.strong,{children:`closed loop`}),`.`]}),`\n`,_jsx(_components.p,{children:`In our orchestration platform, we can support network tokens across any open-loop\npayment services. You don’t have to perform any additional integrations to use network\ntokens besides storing the original card data (PAN) in our Cloud Vault.\nYou can follow the regular flow of card integrations, and we will automatically swap out\nthe original card details with the network token when possible.`}),`\n`,_jsx(_components.p,{children:`For each first time use of the token a cryptogram is provisioned. Subsequent merchant initiated\ntransactions (MIT) will not need a cryptogram (these are optional), unless the transaction is done\nwith a newly provisioned token. For example if you have migrated an already running billing\nsequence for a card to our systems and for these cards you’re provisioning tokens for the first time,\nthe first transaction done with that token will have a cryptogram provisioned automatically by mattilda Pay.\nThe token and cryptogram will be provisioned as “on file” and therefore the buyer does not have\nto be present for the provisioning of either the token or the cryptogram.`}),`\n`,_jsx(_components.p,{children:`We have optimized the usage of network tokens by implementing scheme best practices\nregarding cryptogram usage, as well as the correct payment flagging towards the payment services.\nUsing Flow, it will be possible to choose the instrument (PAN or Network token) in your\nrouting rules, allowing you to optimize your routing behavior.`}),`\n`,_jsx(_components.p,{children:`For best practices and advice on routing optimizations, please reach out to our support team.`}),`\n`,_jsx(Heading,{level:`2`,id:`standalone-tokenization-endpoints`,children:`Standalone tokenization endpoints`}),`\n`,_jsx(_components.p,{children:`Our API allows you to provision network tokens and cryptograms for use in your own system.\nPlease note that network tokens can be considered PCI sensitive data depending on your\ninterpretation of PCI guidelines, and therefore these API’s are not enabled in production by default.`}),`\n`,_jsxs(_components.p,{children:[`You can use the `,_jsx(_components.a,{href:`/reference/network-tokens/`,children:`network token endpoints`}),` to obtain network tokens and their cryptograms\nfor use in your own system.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Network token provisioning via the API is not enabled by default in production.\nPlease contact support for further guidance.`})})]})}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":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Network token implementation","sidebarTitle":"Implementation","description":"How to use scheme tokens with or without payment orchestration","href":"/guides/features/network-tokens/implementation"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Automatic provisioning of network tokens","slug":"automatic-provisioning-of-network-tokens","depth":2,"children":[]},{"title":"Standalone tokenization endpoints","slug":"standalone-tokenization-endpoints","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/mattilda/eb353c0e6fdb81a8/assets/data/payment-service-definitions.js"],"subdomain":"mattilda","siteName":"mattilda Pay","title":"Network token implementation - mattilda Pay","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2025-08-13T00:05:35.087Z","originalFileLocation":"guides/features/network-tokens/implementation.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"How to use scheme tokens with or without payment orchestration\">\u003cmeta data-mint-head name=\"application-name\" content=\"mattilda Pay\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/mattilda/OkS2-p2fdXqcdBmD/_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/mattilda/OkS2-p2fdXqcdBmD/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/mattilda/OkS2-p2fdXqcdBmD/_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/mattilda/OkS2-p2fdXqcdBmD/_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/mattilda/OkS2-p2fdXqcdBmD/_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/mattilda/OkS2-p2fdXqcdBmD/_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/mattilda/OkS2-p2fdXqcdBmD/_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/mattilda/OkS2-p2fdXqcdBmD/_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/mattilda/OkS2-p2fdXqcdBmD/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Network token implementation - mattilda Pay\">\u003cmeta data-mint-head property=\"og:description\" content=\"How to use scheme tokens with or without payment orchestration\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"mattilda Pay\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.mattildapayments.com/guides/features/network-tokens/implementation\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://mattilda.mintlify.app/_mintlify/api/og/v2?division=Network+tokens\u0026amp;title=Network+token+implementation\u0026amp;description=How+to+use+scheme+tokens+with+or+without+payment+orchestration\u0026amp;theme=1bb22e23ee692bf7bb82e1f1\u0026amp;signature=06a42557708b33af6d89ad488eabf040627f3b65e1e594881372402d95cab8e0\">\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=\"Network token implementation - mattilda Pay\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"How to use scheme tokens with or without payment orchestration\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://mattilda.mintlify.app/_mintlify/api/og/v2?division=Network+tokens\u0026amp;title=Network+token+implementation\u0026amp;description=How+to+use+scheme+tokens+with+or+without+payment+orchestration\u0026amp;theme=1bb22e23ee692bf7bb82e1f1\u0026amp;signature=06a42557708b33af6d89ad488eabf040627f3b65e1e594881372402d95cab8e0\">\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/mattilda/OkS2-p2fdXqcdBmD/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"mattilda Pay\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0069ED\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.mattildapayments.com/guides/features/network-tokens/implementation\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/guides/features/network-tokens/implementation.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.mattildapayments.com/#organization\",\"name\":\"mattilda Pay\",\"url\":\"https://docs.mattildapayments.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/mattilda/yVMPq-_dro0vSEiX/assets/logos/light.svg?fit=max\u0026auto=format\u0026n=yVMPq-_dro0vSEiX\u0026q=85\u0026s=ebe404856efad414fe0e5816e122fbf3\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.mattildapayments.com#website\",\"name\":\"mattilda Pay\",\"url\":\"https://docs.mattildapayments.com\",\"publisher\":{\"@id\":\"https://docs.mattildapayments.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.mattildapayments.com/guides/features/network-tokens/implementation#webpage\",\"url\":\"https://docs.mattildapayments.com/guides/features/network-tokens/implementation\",\"name\":\"Network token implementation\",\"description\":\"How to use scheme tokens with or without payment orchestration\",\"dateModified\":\"2025-08-13T00:05:35.087Z\",\"isPartOf\":{\"@id\":\"https://docs.mattildapayments.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.mattildapayments.com/guides/features/network-tokens/implementation#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.mattildapayments.com/guides/features/network-tokens/implementation#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Features\",\"item\":\"https://docs.mattildapayments.com/guides/features/3ds/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Network tokens\",\"item\":\"https://docs.mattildapayments.com/guides/features/network-tokens/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Network token implementation\",\"item\":\"https://docs.mattildapayments.com/guides/features/network-tokens/implementation\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.mattildapayments.com/guides/features/network-tokens/implementation#article\",\"headline\":\"Network token implementation\",\"name\":\"Network token implementation\",\"description\":\"How to use scheme tokens with or without payment orchestration\",\"url\":\"https://docs.mattildapayments.com/guides/features/network-tokens/implementation\",\"mainEntityOfPage\":{\"@id\":\"https://docs.mattildapayments.com/guides/features/network-tokens/implementation#webpage\"},\"dateModified\":\"2025-08-13T00:05:35.087Z\",\"publisher\":{\"@id\":\"https://docs.mattildapayments.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.mattildapayments.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"mattilda Pay\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"mattilda Pay","nav":{"global":null,"tabs":[{"tab":"Payments","groups":[{"group":"Getting Started","pages":[{"sidebarTitle":"Overview","title":"Getting started with mattilda Pay","mode":"wide","href":"/guides/get-started"}]},{"group":"Integration","pages":[{"group":"Embed","pages":[{"group":"Quick start","pages":[{"title":"Embed","sidebarTitle":"Introduction","href":"/guides/payments/embed/quick-start/overview"},{"title":"Step 1: Create an API key for use with Embed","sidebarTitle":"1. Create API key","href":"/guides/payments/embed/quick-start/key"},{"title":"Step 2: Generate a client token for use with Embed","sidebarTitle":"2. Generate token","href":"/guides/payments/embed/quick-start/sdks"},{"title":"Step 3: Add Embed","sidebarTitle":"3. Embed checkout","href":"/guides/payments/embed/quick-start/embed"},{"title":"Step 4: Inspect a transaction","sidebarTitle":"4. Inspect transaction","href":"/guides/payments/embed/quick-start/inspect"},{"title":"Step 5: Go live","sidebarTitle":"5. Go live","href":"/guides/payments/embed/quick-start/live"}]},{"title":"Digital wallets in Embed","sidebarTitle":"Digital wallets","href":"/guides/payments/embed/digital-wallets"},{"title":"Embed events","sidebarTitle":"Events","href":"/guides/payments/embed/events"},{"title":"Embed localization","sidebarTitle":"Locales","href":"/guides/payments/embed/locale"},{"title":"Embed Theming","sidebarTitle":"Theming","href":"/guides/payments/embed/theming"},{"title":"Embed options","sidebarTitle":"Options","mode":"wide","href":"/guides/payments/embed/options"},{"title":"In-app browsers with Embed","sidebarTitle":"In-app browsers","href":"/guides/payments/embed/in-app-browsers"},{"title":"Common issues with Embed","sidebarTitle":"Common issues","href":"/guides/payments/embed/common-issues"}]},{"group":"Secure Fields","pages":[{"group":"Quick start","pages":[{"title":"Secure Fields","sidebarTitle":"Introduction","href":"/guides/payments/secure-fields/quick-start/overview"},{"title":"Step 1: Create an API key for use with Secure Fields","sidebarTitle":"1. Create API key","href":"/guides/payments/secure-fields/quick-start/key"},{"title":"Step 2: Create a checkout sessions","sidebarTitle":"2. Create a session","href":"/guides/payments/secure-fields/quick-start/sdks"},{"title":"Step 3: Add secure fields","sidebarTitle":"3. Add secure fields","href":"/guides/payments/secure-fields/quick-start/embed"},{"title":"Step 4: Create a transaction","sidebarTitle":"4. Create transaction","href":"/guides/payments/secure-fields/quick-start/transact"}]},{"title":"Secure Fields with stored cards","sidebarTitle":"Stored cards","href":"/guides/payments/secure-fields/stored-cards"},{"title":"Secure Fields theming","sidebarTitle":"Theming","href":"/guides/payments/secure-fields/theming"},{"title":"Secure Fields events","sidebarTitle":"Events","href":"/guides/payments/secure-fields/events"},{"title":"Click to Pay with Secure Fields","sidebarTitle":"Click to Pay","href":"/guides/payments/secure-fields/click-to-pay"},{"title":"Secure Fields and 3DS","sidebarTitle":"3DS","href":"/guides/payments/secure-fields/three-d-secure"}]},{"group":"Direct API","pages":[{"group":"Quick start","pages":[{"title":"Direct API","sidebarTitle":"Introduction","href":"/guides/payments/direct-api/quick-start/overview"},{"title":"Step 1: Authentication","sidebarTitle":"1. Authentication","href":"/guides/payments/direct-api/quick-start/key"},{"title":"Step 2: Get a list of payment options","sidebarTitle":"2. Get payment options","href":"/guides/payments/direct-api/quick-start/payment-options"},{"title":"Step 3: Create a transaction","sidebarTitle":"3. Create transaction","href":"/guides/payments/direct-api/quick-start/transaction"},{"title":"Step 4: Handle redirect","sidebarTitle":"4. Handle redirect","href":"/guides/payments/direct-api/quick-start/handle-redirect"},{"title":"Step 5: Get transaction result","sidebarTitle":"5. Get transaction result","href":"/guides/payments/direct-api/quick-start/status"}]}]},{"group":"Android SDK","pages":[{"group":"Quick start","pages":[{"title":"Android SDK","sidebarTitle":"Introduction","href":"/guides/payments/android/quick-start/overview"},{"title":"Step 1: Create an API key for use with Android","sidebarTitle":"1. Create API key","href":"/guides/payments/android/quick-start/key"},{"title":"Step 2: Generate a client token for use with Android","sidebarTitle":"2. Generate token","href":"/guides/payments/android/quick-start/sdks"},{"title":"Step 3: Install the Android SDK","sidebarTitle":"3. Install Android SDK","href":"/guides/payments/android/quick-start/android"},{"title":"Step 4: Create a transaction","sidebarTitle":"4. Create transaction","href":"/guides/payments/android/quick-start/transact"}]},{"title":"Google Pay on Android","sidebarTitle":"Google Pay","href":"/guides/payments/android/google-pay"},{"title":"Android events","sidebarTitle":"Events","href":"/guides/payments/android/events"},{"title":"Android options","sidebarTitle":"Options","mode":"wide","href":"/guides/payments/android/options"}]},{"group":"iOS SDK","pages":[{"group":"Quick start","pages":[{"title":"iOS SDK","sidebarTitle":"Introduction","href":"/guides/payments/ios/quick-start/overview"},{"title":"Step 1: Create an API key for use with iOS","sidebarTitle":"1. Create API key","href":"/guides/payments/ios/quick-start/key"},{"title":"Step 2: Generate a client token for use with iOS","sidebarTitle":"2. Generate token","href":"/guides/payments/ios/quick-start/sdks"},{"title":"Step 3: Install the iOS SDK","sidebarTitle":"3. Install iOS SDK","href":"/guides/payments/ios/quick-start/ios"},{"title":"Step 4: Create a transaction","sidebarTitle":"4. Create transaction","href":"/guides/payments/ios/quick-start/transact"}]},{"title":"Apple Pay on iOS","sidebarTitle":"Apple Pay","href":"/guides/payments/ios/apple-pay"},{"title":"iOS events","sidebarTitle":"Events","href":"/guides/payments/ios/events"},{"title":"iOS options","sidebarTitle":"Options","mode":"wide","href":"/guides/payments/ios/options"}]},{"group":"React Native","pages":[{"group":"Quick start","pages":[{"title":"React Native SDK","sidebarTitle":"Introduction","href":"/guides/payments/react-native/quick-start/overview"},{"title":"Step 1: Create an API key for use with React Native","sidebarTitle":"1. Create API key","href":"/guides/payments/react-native/quick-start/key"},{"title":"Step 2: Generate a client token for use with React Native","sidebarTitle":"2. Generate token","href":"/guides/payments/react-native/quick-start/sdks"},{"title":"Step 3: Install the React Native SDK","sidebarTitle":"3. Install React Native SDK","href":"/guides/payments/react-native/quick-start/embed"},{"title":"Step 4: Create a transaction","sidebarTitle":"4. Create transaction","href":"/guides/payments/react-native/quick-start/transact"}]},{"title":"Apple Pay on React Native","sidebarTitle":"Apple Pay","href":"/guides/payments/react-native/apple-pay"},{"title":"Google Pay on React Native","sidebarTitle":"Google Pay","href":"/guides/payments/react-native/google-pay"},{"title":"React Native events","sidebarTitle":"Events","href":"/guides/payments/react-native/events"},{"title":"React Native options","sidebarTitle":"Options","mode":"wide","href":"/guides/payments/react-native/options"}]},{"group":"E-commerce Plugins","pages":[{"group":"commercetools","pages":[{"title":"commercetools Integration","sidebarTitle":"Overview","href":"/guides/payments/commercetools/overview"},{"title":"commercetools Installation","sidebarTitle":"Installation","href":"/guides/payments/commercetools/installation"},{"title":"commercetools Configuration","sidebarTitle":"Configuration","href":"/guides/payments/commercetools/configuration"},{"title":"commercetools Administration","sidebarTitle":"Administration","href":"/guides/payments/commercetools/backend"},{"title":"commercetools Frontend","sidebarTitle":"Frontend","href":"/guides/payments/commercetools/frontend"}]},{"group":"Magento","pages":[{"title":"Magento Plugin","sidebarTitle":"Overview","href":"/guides/payments/magento/overview"},{"title":"Magento Installation","sidebarTitle":"Installation","href":"/guides/payments/magento/installation"},{"title":"Magento Configuration","sidebarTitle":"Configuration","href":"/guides/payments/magento/configuration"},{"title":"Magento Administration","sidebarTitle":"Administration","href":"/guides/payments/magento/backend"},{"title":"Magento Frontend","sidebarTitle":"Frontend","href":"/guides/payments/magento/frontend"}]},{"group":"Salesforce Commerce Cloud","pages":[{"title":"Salesforce Commerce Cloud Cartridge","sidebarTitle":"Overview","href":"/guides/payments/sfcc/overview"},{"title":"Salesforce Commerce Cloud Installation","sidebarTitle":"Installation","href":"/guides/payments/sfcc/installation"},{"title":"Salesforce Commerce Cloud Configuration","sidebarTitle":"Configuration","href":"/guides/payments/sfcc/configuration"},{"title":"Salesforce Commerce Cloud Administration","sidebarTitle":"Administration","href":"/guides/payments/sfcc/backend"},{"title":"Salesforce Commerce Cloud Frontend","sidebarTitle":"Frontend","href":"/guides/payments/sfcc/frontend"}]}]}]},{"group":"Tools","pages":[{"title":"Command Line Interface (CLI)","sidebarTitle":"CLI","href":"/guides/tools/cli"},{"title":"Postman Collection","sidebarTitle":"Postman","href":"/guides/tools/postman"}]},{"group":"Cloud Vault","pages":[{"group":"Import card data","pages":[{"title":"Vault token import","sidebarTitle":"Overview","href":"/guides/features/token-import/overview"},{"title":"Token import file creation","sidebarTitle":"Import file","mode":"wide","href":"/guides/features/token-import/token-import-file"},{"title":"Token import file upload","sidebarTitle":"Upload tokens","href":"/guides/features/token-import/token-file-transmission"},{"title":"Creating buyers \u0026 payment methods on import","sidebarTitle":"Buyers \u0026 payment methods","href":"/guides/features/token-import/buyer-payment-creation"}]},{"group":"Vault Forward","pages":[{"title":"Vault Forward","sidebarTitle":"Overview","href":"/guides/features/vault-forwarding/overview"},{"title":"Enable a Vault Forward endpoint","sidebarTitle":"Enable endpoint","href":"/guides/features/vault-forwarding/enable"},{"title":"Vault Forward card data to API endpoint","sidebarTitle":"Forward to endpoint","href":"/guides/features/vault-forwarding/forward"},{"title":"Vault Forward card data from a checkout session","sidebarTitle":"CVV \u0026 Secure Fields","href":"/guides/features/vault-forwarding/checkout-sessions"},{"group":"Advanced authentication","pages":[{"title":"Advanced authentication for Vault Forward","sidebarTitle":"Overview","href":"/guides/features/vault-forwarding/authentication"},{"title":"Advanced authentication for Visa","sidebarTitle":"Visa","href":"/guides/features/vault-forwarding/visa"}]}]}]},{"group":"Features","pages":[{"group":"3-D Secure","pages":[{"title":"3-D Secure","sidebarTitle":"Overview","href":"/guides/features/3ds/overview"},{"title":"Setup 3-D Secure","sidebarTitle":"Setup","href":"/guides/features/3ds/setup"},{"title":"3-D Secure in Embed","sidebarTitle":"Embed","href":"/guides/features/3ds/embed"},{"title":"Hosted 3-D Secure","sidebarTitle":"Hosted via API","href":"/guides/features/3ds/hosted"},{"title":"External 3-D Secure server","sidebarTitle":"External 3DS server","href":"/guides/features/3ds/external"},{"title":"3-D Secure Testing","sidebarTitle":"Testing","href":"/guides/features/3ds/testing"}]},{"group":"Account updater","pages":[{"title":"Account Updater","sidebarTitle":"Overview","href":"/guides/features/account-updater/overview"},{"title":"Manual account updates","sidebarTitle":"Manual updates","href":"/guides/features/account-updater/integration"},{"title":"Scheduled account updates","sidebarTitle":"Scheduled updates","href":"/guides/features/account-updater/scheduler"},{"title":"Real time","href":"/guides/features/account-updater/real-time"}]},{"group":"AFTs","pages":[{"title":"Overview","href":"/guides/features/account-funding-transactions/overview"}]},{"group":"Anti-fraud","pages":[{"title":"Anti-fraud","sidebarTitle":"Overview","href":"/guides/features/anti-fraud/overview"},{"title":"Automatic anti-fraud device fingerprinting","sidebarTitle":"Fingerprints","href":"/guides/features/anti-fraud/fingerprint"},{"title":"Anti-fraud reviews","sidebarTitle":"Reviews","href":"/guides/features/anti-fraud/reviews"}]},{"group":"Apple Pay","pages":[{"title":"Apple Pay","sidebarTitle":"Overview","href":"/guides/features/apple-pay/overview"},{"title":"Apple Pay on web with Embed","sidebarTitle":"Web with Embed","href":"/guides/features/apple-pay/web"},{"title":"Apple Pay on web without Embed","sidebarTitle":"Web without Embed","href":"/guides/features/apple-pay/web-without-sdk"},{"title":"Apple Pay on iOS with the SDK","sidebarTitle":"iOS with SDK","href":"/guides/features/apple-pay/ios"},{"title":"Apple Pay on iOS without the SDK","sidebarTitle":"iOS without SDK","href":"/guides/features/apple-pay/ios-without-sdk"},{"title":"Decrypted Apple Pay tokens","sidebarTitle":"Decrypted tokens","href":"/guides/features/apple-pay/decrypted-tokens"}]},{"group":"Google Pay","pages":[{"title":"Google Pay","sidebarTitle":"Overview","href":"/guides/features/google-pay/overview"},{"title":"Google Pay on web with Embed","sidebarTitle":"Web with Embed","href":"/guides/features/google-pay/web"},{"title":"Google Pay on web without Embed","sidebarTitle":"Web without Embed","href":"/guides/features/google-pay/web-without-sdk"},{"title":"Google Pay on Android with the SDK","sidebarTitle":"Android with SDK","href":"/guides/features/google-pay/mobile"},{"title":"Google Pay on Android without the SDK","sidebarTitle":"Android without SDK","href":"/guides/features/google-pay/mobile-without-sdk"},{"title":"Decrypted Google Pay tokens","sidebarTitle":"Decrypted tokens","href":"/guides/features/google-pay/decrypted-tokens"}]},{"group":"Guest checkout","pages":[{"title":"Guest checkout","sidebarTitle":"Overview","href":"/guides/features/guest-checkout/overview"},{"title":"Linking guests buyer details","sidebarTitle":"Buyer linking","href":"/guides/features/guest-checkout/linking"}]},{"group":"Network tokens","pages":[{"title":"Network tokens","sidebarTitle":"Overview","description":"Using scheme tokens with payment orchestration","href":"/guides/features/network-tokens/overview"},{"title":"Network token implementation","sidebarTitle":"Implementation","href":"/guides/features/network-tokens/implementation"},{"title":"Network token lifecycle management","sidebarTitle":"Lifecycle","description":"Managing the full lifecycle of network tokens","href":"/guides/features/network-tokens/lifecycle"},{"title":"Network Token Testing","sidebarTitle":"Testing","href":"/guides/features/network-tokens/testing"},{"title":"Network token pass through","sidebarTitle":"Pass through","href":"/guides/features/network-tokens/passthrough"}]},{"group":"Payment links","pages":[{"title":"Payment links","sidebarTitle":"Overview","href":"/guides/features/payment-links/overview"},{"title":"Sharing the payment link","sidebarTitle":"Sharing","href":"/guides/features/payment-links/sharing"},{"title":"Payment link expiration and statuses","sidebarTitle":"Expiration \u0026 Status","href":"/guides/features/payment-links/statuses"}]},{"group":"Recurring payments","pages":[{"title":"Recurring payments","sidebarTitle":"Overview","href":"/guides/features/recurring-payments/overview"},{"title":"Common scenarios","href":"/guides/features/recurring-payments/scenarios"},{"title":"Recurring transactions with Embed","sidebarTitle":"In Embed","href":"/guides/features/recurring-payments/embed"},{"title":"Open-loop versus closed-loop","sidebarTitle":"Open or Closed-loop","href":"/guides/features/recurring-payments/open-loop"},{"title":"Recurring payments with network tokens","sidebarTitle":"Network tokens","href":"/guides/features/recurring-payments/network-tokens"}]},{"group":"Scheme Cards","pages":[{"title":"Card fingerprints","sidebarTitle":"Card fingerprints","href":"/guides/features/cards/fingerprints"}]},{"group":"Simulators","pages":[{"title":"Transaction simulators","sidebarTitle":"Overview","href":"/guides/features/simulators/overview"}]},{"group":"SPEI","pages":[{"title":"SPEI bank transfers","sidebarTitle":"Overview","href":"/guides/features/spei/overview"}]},{"group":"Webhooks","pages":[{"title":"Webhooks","sidebarTitle":"Introduction","href":"/guides/features/webhooks/overview"},{"title":"Webhook payload","sidebarTitle":"Payload","href":"/guides/features/webhooks/payload"},{"title":"Webhook events","sidebarTitle":"Events","mode":"wide","href":"/guides/features/webhooks/events"},{"title":"Technical webhook considerations","sidebarTitle":"Technical considerations","href":"/guides/features/webhooks/technical-considerations"},{"title":"Webhook signatures","sidebarTitle":"Signatures","href":"/guides/features/webhooks/signatures"}]}]},{"group":"Other","pages":[{"group":"API","pages":[{"title":"Best practice","href":"/guides/best-practice"},{"title":"Transaction error codes","sidebarTitle":"Error Codes","mode":"wide","href":"/guides/api/error-codes"}]},{"group":"Statuses","pages":[{"title":"Transaction statuses","sidebarTitle":"Transactions","href":"/guides/api/statuses/transactions"},{"title":"Payment method statuses","sidebarTitle":"Payment methods","href":"/guides/api/statuses/payment-methods"}]}]}]},{"tab":"Dashboard","pages":[{"title":"Dashboard","href":"/guides/dashboard/insights/homepage"}]},{"tab":"API Reference","icon":{"style":"light","name":"square-terminal"},"pages":[{"title":"API Reference","href":"/guides/api/authentication"}]},{"tab":"Updates","hidden":true,"pages":[{"title":"Updates","href":"/updates"}]}]},"basePath":"","title":"Network token implementation - mattilda Pay","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":[],"chunks":[]}