"transactionMode" is used for tokenization and tokenized payments. The value "initialUnescheduled" tokenizes details for future one-time, unscheduled payments. The value "initialRecurring' tokenizes details for the first in a series of scheduled payments. The value "cardHolderInitiatedUnescheduled" is for subsequent unscheduled payment initiated by the cardholder. The value "merchantInitiatedUnescheduled" is for unscheduled payment initiated by the merchant. The value "merchantInitiatedRecurring" is for subsequent scheduled payment initiated by the merchant.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Paybyrd","colors":{"primary":"#6319F0","light":"#A4ADFF","dark":"#6319F0"},"logo":{"light":"https://mintcdn.com/paybyrd/X3OHHz6EJVWhNTO3/images/logo-light-full.png?fit=max\u0026auto=format\u0026n=X3OHHz6EJVWhNTO3\u0026q=85\u0026s=35a8f83493759c89b1ee80db71265676","dark":"https://mintcdn.com/paybyrd/X3OHHz6EJVWhNTO3/images/logo-dark-full.png?fit=max\u0026auto=format\u0026n=X3OHHz6EJVWhNTO3\u0026q=85\u0026s=7d1a41429a1708ce79ff23f45f296959"},"favicon":"https://mintcdn.com/paybyrd/GOPy9l9hDJ70VNa1/images/Avatar-Square.png?fit=max\u0026auto=format\u0026n=GOPy9l9hDJ70VNa1\u0026q=85\u0026s=78f2ae4b46f5e013c30d747f9889aa80","background":{"color":{"light":"#f2f2f2","dark":"#2e2e2e"}},"navbar":{"links":[{"href":"https://www.paybyrd.com/","label":"Paybyrd"},{"href":"https://status.paybyrd.com/","label":"Status"}],"primary":{"type":"button","label":"Get started with Paybyrd","href":"https://backoffice.paybyrd.com/"}},"footer":{"socials":{"website":"https://www.paybyrd.com/"},"links":[{"header":"Mobile","items":[{"label":"Get the dashboard app","href":"/get-started/start-building"}]}]},"fonts":{"family":"DM Sans","weight":400,"source":"https://fonts.gstatic.com/s/dmsans/v17/rP2Yp2ywxg089UriI5-g7M8btVsD8Ck0q7u0-K6z8GXhnU0.woff2","format":"woff2"},"icons":{"library":"lucide"},"integrations":{"ga4":{"measurementId":"G-7PQTSPLP9K"}},"contextual":{"options":["copy","view","vscode","chatgpt","claude","mcp","add-mcp"],"display":"toc"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"paybyrd","hasAudioNarration":false,"actualSubdomain":"paybyrd","customDomains":["docs.paybyrd.com"],"gitSource":{"type":"github","owner":"paybyrd","repo":"paybyrd-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adfac3b1ec88bdf5ff40127","collectionId":"99135064-27cc-4e8f-a205-a81518acd153","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adfac3b1ec88bdf5ff40127"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6adfac3b1ec88bdf5ff40127","clientVersion":"0.0.4045","searchFilterCounts":[{"language":"default","tag":"API Reference","count":30},{"language":"default","tag":"Payments API","count":26},{"language":"default","tag":"Payments","count":23},{"language":"default","tag":"Integrations","count":14},{"language":"default","tag":"Accept Payments","count":13},{"language":"default","tag":"Get started","count":8},{"language":"default","tag":"Manage Payments","count":8},{"language":"default","tag":"Transactions","count":8},{"language":"default","tag":"Webhooks","count":8},{"language":"default","tag":"Point of Sale","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/tokenization/create-token","slug":"/api-reference/tokenization/create-token","pageMetadata":{"title":"Create Token","description":"Create a Token for future transactions","deprecated":false,"version":null,"openapi":"/openapi.yml post /api/v2/tokens","href":"/api-reference/tokenization/create-token","autogeneratedByOpenApi":true},"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: \"Create a Token for future transactions\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create Token","description":"Create a Token for future transactions","deprecated":false,"version":null,"openapi":"/openapi.yml post /api/v2/tokens","href":"/api-reference/tokenization/create-token","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Tokenization"],"summary":"Create Token","description":"Create a Token for future transactions","operationId":"api-tokenize-create","requestBody":"1b261a9d-9a8b-4b8d-9bbc-a29088b8d7b2","responses":{"201":"4b88e488-9a2e-42f2-bfa5-973f58e14f61"},"deprecated":false,"method":"post","type":"path","servers":["72fd1cc1-663b-467d-beb5-358ad27a2640"],"security":["25788e77-5004-4d78-a9a1-daae3364455d"],"path":"/api/v2/tokens","baseUrlOptions":["https://gateway.paybyrd.com"],"title":"Create Token","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["Type","Card","CustomReference","Alias","RedirectUrl"],"properties":{"Type":{"type":"string","description":"Identity the type of the token (currently only \"card\")","example":"Card","isRequired":true,"uniqueKey":"Type","typeLabel":"string"},"CustomReference":{"type":"string","description":"Identify the token by an aggregation reference of your business (CustomerId, WalletId, StoreId ...)","example":"Wallet123","isRequired":true,"uniqueKey":"CustomReference","typeLabel":"string"},"Alias":{"type":"string","description":"Alias for the new token (usually provided by the customer)","example":"MyShoppingCard","isRequired":true,"uniqueKey":"Alias","typeLabel":"string"},"RedirectUrl":{"type":"string","description":"The url that redirect the user at the end of 3ds validation (in fail, succes and reject cases)","example":"http://client.co/3ds/validation?token=123456","isRequired":true,"uniqueKey":"RedirectUrl","typeLabel":"string"},"Card":{"type":"object","required":["number","expiration","cvv","holder"],"properties":{"number":{"type":"string","description":"The card number","example":"5149682323738886","isRequired":true,"uniqueKey":"Card.number","typeLabel":"string"},"expiration":{"type":"string","description":"The card expiration date with pattern \"MM/YY\"","example":"03/29","isRequired":true,"uniqueKey":"Card.expiration","typeLabel":"string"},"cvv":{"type":"string","description":"The Card Verification Value","example":"929","isRequired":true,"uniqueKey":"Card.cvv","typeLabel":"string"},"holder":{"type":"string","description":"The card holder name","example":"Peter Parker","isRequired":true,"uniqueKey":"Card.holder","typeLabel":"string"},"aav":{"type":"string","description":"The authentication value returned by the 3DS authentication","uniqueKey":"Card.aav","typeLabel":"string"},"dsTransactionId":{"type":"string","description":"The transaction id returned by the Directory Server executed on 3DS authentication","uniqueKey":"Card.dsTransactionId","typeLabel":"string"},"eci":{"type":"string","description":"The card ECI code returned by the 3DS authentication","uniqueKey":"Card.eci","typeLabel":"string"},"xid":{"type":"string","description":"The card transaction identifier returned by the 3DS authentication","uniqueKey":"Card.xid","typeLabel":"string"},"verificationMethod":{"type":"string","description":"The card verification method indicates if the 3DS was previously performed. When this value is not provided, Paybyrd will respond with the action URL to initiate the 3D Secure flow. For that case, a second step will be required for the payment creation. For 'ThreeDSecure' it is also necessary to provide the 3DS authentication data (aav, dsTransactionId, eci and threeDsVersion). When 'ThreeDSecureAttempt' is provided, a proof of attempt must also be sent. In case you want Paybyrd to handle all the 3DS flow, you must leave this field empty. For this scenario, we will respond with an Action Url that must be triggered on the client side. This will trigger the 3DS flow automatically.","enum":["ThreeDSecure","ThreeDSecureAttempt","None"],"uniqueKey":"Card.verificationMethod","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"Card","typeLabel":"object"},"TransactionMode":{"type":"string","description":"\"transactionMode\" is used for tokenization and tokenized payments. The value \"initialUnescheduled\" tokenizes details for future one-time, unscheduled payments. The value \"initialRecurring' tokenizes details for the first in a series of scheduled payments. The value \"cardHolderInitiatedUnescheduled\" is for subsequent unscheduled payment initiated by the cardholder. The value \"merchantInitiatedUnescheduled\" is for unscheduled payment initiated by the merchant. The value \"merchantInitiatedRecurring\" is for subsequent scheduled payment initiated by the merchant.","enum":["initialUnescheduled","initialRecurring","cardHolderInitiatedUnescheduled","merchantInitiatedUnescheduled","merchantInitiatedRecurring"],"uniqueKey":"TransactionMode","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"Type":"Card","CustomReference":"Wallet123","Alias":"MyShoppingCard","RedirectUrl":"http://client.co/3ds/validation?token=123456","Card":{"number":"5149682323738886","expiration":"03/29","cvv":"929","holder":"Peter Parker","aav":"\u003cstring>","dsTransactionId":"\u003cstring>","eci":"\u003cstring>","xid":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"4b88e488-9a2e-42f2-bfa5-973f58e14f61":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"card":{"type":"object","properties":{"number":{"type":"string","description":"The masked card number","example":"514968******8886","uniqueKey":"card.number","typeLabel":"string"},"expiration":{"type":"string","description":"The card expiration date with pattern \"MM/YY\"","example":"03/29","uniqueKey":"card.expiration","typeLabel":"string"},"cvv":{"type":"string","description":"The masked card verification value","example":"***","uniqueKey":"card.cvv","typeLabel":"string"},"holder":{"type":"string","description":"The card holder name","example":"Peter Parker","uniqueKey":"card.holder","typeLabel":"string"},"aav":{"type":"string","description":"The authentication value returned by the 3DS authentication","uniqueKey":"card.aav","typeLabel":"string"},"dsTransactionId":{"type":"string","description":"The transaction id returned by the Directory Server executed on 3DS authentication","uniqueKey":"card.dsTransactionId","typeLabel":"string"},"eci":{"type":"string","description":"The card ECI code returned by the 3DS authentication","uniqueKey":"card.eci","typeLabel":"string"},"xid":{"type":"string","description":"The card transaction identifier returned by the 3DS authentication","uniqueKey":"card.xid","typeLabel":"string"},"verificationMethod":{"type":"string","description":"The card verification method indicates if the 3DS was previously performed. ","enum":["ThreeDSecure","ThreeDSecureAttempt","None"],"uniqueKey":"card.verificationMethod","typeLabel":"enum\u003cstring>"},"scheme":{"type":"string","description":"The card scheme. This field will not be always available in the response.","enum":["Undefined","Visa","Master","Amex","JCB","Diners","Discover"],"uniqueKey":"card.scheme","typeLabel":"enum\u003cstring>"},"usage":{"type":"string","description":"The card usage. This field will not be always available in the response.","enum":["Undefined","Credit","Debit"],"uniqueKey":"card.usage","typeLabel":"enum\u003cstring>"},"countryCode":{"type":"string","description":"Three letter country code (ISO 3166). This field will not be always available in the response.","example":"PRT","uniqueKey":"card.countryCode","typeLabel":"string"}},"uniqueKey":"card","typeLabel":"object"},"tokenId":{"type":"string","description":"The id of generated token","example":"5d3491c3-8978-4ff5-8d74-31b0b0499b01","uniqueKey":"tokenId","typeLabel":"string"},"customReference":{"type":"string","description":"The customReference sent in the CardTokenizeRequest","example":"Wallet123","uniqueKey":"customReference","typeLabel":"string"},"alias":{"type":"string","description":"The Alias sent in the CardTokenizeRequest","example":"PersonalCard","uniqueKey":"alias","typeLabel":"string"},"action":{"type":"object","required":["type","url"],"properties":{"type":{"type":"string","description":"The type of the action to be taken by the merchant","enum":["redirect"],"isRequired":true,"uniqueKey":"action.type","typeLabel":"enum\u003cstring>"},"url":{"type":"string","description":"The URL to be used in order to finalize the payment","example":"https://gateway.paybyrd.com/v1/ThreeDSecure/InitiatePayment?transactionId=0411c4cf-3d6c-4315-ac5e-98fb1d72f11f","isRequired":true,"uniqueKey":"action.url","typeLabel":"string"}},"uniqueKey":"action","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"card":{"number":"514968******8886","expiration":"03/29","cvv":"***","holder":"Peter Parker","aav":"\u003cstring>","dsTransactionId":"\u003cstring>","eci":"\u003cstring>","xid":"\u003cstring>","verificationMethod":"ThreeDSecure","scheme":"Undefined","usage":"Undefined","countryCode":"PRT"},"tokenId":"5d3491c3-8978-4ff5-8d74-31b0b0499b01","customReference":"Wallet123","alias":"PersonalCard","action":{"type":"redirect","url":"https://gateway.paybyrd.com/v1/ThreeDSecure/InitiatePayment?transactionId=0411c4cf-3d6c-4315-ac5e-98fb1d72f11f"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"25788e77-5004-4d78-a9a1-daae3364455d":{"authByApiKey":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"authByApiKey"}}},"servers":{"72fd1cc1-663b-467d-beb5-358ad27a2640":{"url":"https://gateway.paybyrd.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"authByApiKey"},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"authByApiKey","name":"x-api-key"}],"title":"authByApiKey"}]},"originalFileLocation":"openapi.yml"},"subdomain":"paybyrd","siteName":"Paybyrd","title":"Create Token - Paybyrd","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-26T19:38:40.699Z","originalFileLocation":"api-reference/tokenization/create-token.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=\"Create a Token for future transactions\">\u003cmeta data-mint-head name=\"application-name\" content=\"Paybyrd\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/paybyrd/ZQOx_ixbIt0VLR4c/_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/paybyrd/ZQOx_ixbIt0VLR4c/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/paybyrd/ZQOx_ixbIt0VLR4c/_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/paybyrd/ZQOx_ixbIt0VLR4c/_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/paybyrd/ZQOx_ixbIt0VLR4c/_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/paybyrd/ZQOx_ixbIt0VLR4c/_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/paybyrd/ZQOx_ixbIt0VLR4c/_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/paybyrd/ZQOx_ixbIt0VLR4c/_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/paybyrd/ZQOx_ixbIt0VLR4c/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Token - Paybyrd\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a Token for future transactions\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Paybyrd\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.paybyrd.com/api-reference/tokenization/create-token\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://paybyrd.mintlify.app/_mintlify/api/og/v2?division=Tokenization\u0026amp;title=Create+Token\u0026amp;description=Create+a+Token+for+future+transactions\u0026amp;theme=482e40cfd6999bc2608c5e34\u0026amp;signature=a835d548bc5db06bb1966367965e32026b16828963551408992769a6722a9bd0\">\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=\"Create Token - Paybyrd\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a Token for future transactions\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://paybyrd.mintlify.app/_mintlify/api/og/v2?division=Tokenization\u0026amp;title=Create+Token\u0026amp;description=Create+a+Token+for+future+transactions\u0026amp;theme=482e40cfd6999bc2608c5e34\u0026amp;signature=a835d548bc5db06bb1966367965e32026b16828963551408992769a6722a9bd0\">\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/paybyrd/ZQOx_ixbIt0VLR4c/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Paybyrd\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6319F0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.paybyrd.com/api-reference/tokenization/create-token\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/tokenization/create-token.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.paybyrd.com/#organization\",\"name\":\"Paybyrd\",\"url\":\"https://docs.paybyrd.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/paybyrd/X3OHHz6EJVWhNTO3/images/logo-light-full.png?fit=max\u0026auto=format\u0026n=X3OHHz6EJVWhNTO3\u0026q=85\u0026s=35a8f83493759c89b1ee80db71265676\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.paybyrd.com#website\",\"name\":\"Paybyrd\",\"url\":\"https://docs.paybyrd.com\",\"publisher\":{\"@id\":\"https://docs.paybyrd.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.paybyrd.com/api-reference/tokenization/create-token#webpage\",\"url\":\"https://docs.paybyrd.com/api-reference/tokenization/create-token\",\"name\":\"Create Token\",\"description\":\"Create a Token for future transactions\",\"dateModified\":\"2026-10-26T19:38:40.699Z\",\"isPartOf\":{\"@id\":\"https://docs.paybyrd.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.paybyrd.com/api-reference/tokenization/create-token#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.paybyrd.com/api-reference/tokenization/create-token#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Payments API\",\"item\":\"https://docs.paybyrd.com/api-reference/payments/create-payment\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Tokenization\",\"item\":\"https://docs.paybyrd.com/api-reference/tokenization/get-token-by-reference\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create Token\",\"item\":\"https://docs.paybyrd.com/api-reference/tokenization/create-token\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.paybyrd.com/api-reference/tokenization/create-token#apireference\",\"headline\":\"Create Token\",\"name\":\"Create Token\",\"description\":\"Create a Token for future transactions\",\"url\":\"https://docs.paybyrd.com/api-reference/tokenization/create-token\",\"mainEntityOfPage\":{\"@id\":\"https://docs.paybyrd.com/api-reference/tokenization/create-token#webpage\"},\"dateModified\":\"2026-10-26T19:38:40.699Z\",\"publisher\":{\"@id\":\"https://docs.paybyrd.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.paybyrd.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Paybyrd\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Paybyrd","nav":{"global":null,"tabs":[{"tab":"Get started","pages":[{"title":"Get started","href":"/introduction"}]},{"tab":"Payments","pages":[{"title":"Payments","href":"/accept-payments/how-it-works"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/embed/checkout"}]},{"tab":"API Reference","groups":[{"group":"API introduction","pages":[{"title":"API intro","href":"/api-reference/api-intro"},{"title":"Response code reference","href":"/api-reference/api-code-reference"},{"title":"Webhook API","href":"/api-reference/webhooks"}]},{"group":"Payments API","expanded":true,"pages":[{"group":"Payments","pages":[{"title":"Create Payment","deprecated":false,"version":null,"openapi":"/openapi.yml post /api/v2/payment","href":"/api-reference/payments/create-payment"},{"title":"Finish two-step card payment","deprecated":false,"version":null,"openapi":"/openapi.yml post /api/v2/payment/{transactionId}/pay","href":"/api-reference/payments/finish-two-step-card-payment"}]},{"group":"Transactions","pages":[{"title":"Refund","deprecated":false,"version":null,"openapi":"/openapi.yml post /api/v2/refund/{transactionId}","href":"/api-reference/transactions/refund"},{"title":"Release","deprecated":false,"version":null,"openapi":"/openapi.yml post /api/v2/release/{transactionId}","href":"/api-reference/transactions/release"},{"title":"Capture","deprecated":false,"version":null,"openapi":"/openapi.yml post /api/v2/capture/{transactionId}","href":"/api-reference/transactions/capture"},{"title":"Cancel","deprecated":false,"version":null,"openapi":"/openapi.yml post /api/v2/cancel/{transactionId}","href":"/api-reference/transactions/cancel"},{"title":"Adjust","deprecated":false,"version":null,"openapi":"/openapi.yml post /api/v2/adjust/{transactionId}","href":"/api-reference/transactions/adjust"},{"title":"Query","deprecated":false,"version":null,"openapi":"/openapi.yml get /api/v2/transactions/{transactionId}","href":"/api-reference/transactions/query"},{"title":"Receipt","deprecated":false,"version":null,"openapi":"/openapi.yml get /api/v2/transactions/{transactionId}/receipt","href":"/api-reference/transactions/receipt"},{"title":"Query by acquirer custom identifier","deprecated":false,"version":null,"openapi":"/openapi.yml get /api/v2/transactions?acquirerCustomId=${customIdentifier}","href":"/api-reference/transactions/query-by-acquirer-custom-identifier"}]},{"group":"Webhooks","pages":[{"title":"Setup URL","deprecated":true,"version":null,"openapi":"/openapi.yml put /api/v1/webhook","href":"/api-reference/webhooks/setup-url"},{"title":"Gets a webhook settings by its Id","deprecated":null,"version":null,"openapi":"/openapi.yml get /api/v2/webhooks/{webhookId}","href":"/api-reference/webhooks/gets-a-webhook-settings-by-its-id"},{"title":"Gets all webhook settings","deprecated":null,"version":null,"openapi":"/openapi.yml get /api/v2/webhooks","href":"/api-reference/webhooks/gets-all-webhook-settings"},{"title":"Creates a new webhook setting","deprecated":null,"version":null,"openapi":"/openapi.yml post /api/v2/webhooks","href":"/api-reference/webhooks/creates-a-new-webhook-setting"},{"title":"Updates a webhook setting url","deprecated":null,"version":null,"openapi":"/openapi.yml patch /api/v2/webhooks/{webhookId}/url","href":"/api-reference/webhooks/updates-a-webhook-setting-url"},{"title":"Enables a webhook setting","deprecated":null,"version":null,"openapi":"/openapi.yml post /api/v2/webhooks/{webhookId}/enable","href":"/api-reference/webhooks/enables-a-webhook-setting"},{"title":"Disables a webhook setting","deprecated":null,"version":null,"openapi":"/openapi.yml post /api/v2/webhooks/{webhookId}/disable","href":"/api-reference/webhooks/disables-a-webhook-setting"},{"title":"Updates a webhook setting url","deprecated":null,"version":null,"openapi":"/openapi.yml patch /api/v2/webhooks/{webhookId}/credentials","href":"/api-reference/webhooks/updates-a-webhook-setting-url-1"}]},{"group":"Paybylink","pages":[{"title":"resend","deprecated":false,"version":null,"openapi":"/openapi.yml post /api/v2/paybylink/{orderId}/resend","href":"/api-reference/paybylink/resend"}]},{"group":"Subscription","pages":[{"title":"Create","deprecated":false,"version":null,"openapi":"/openapi.yml post /api/v2/subscriptions","href":"/api-reference/subscription/create"}]},{"group":"Orders","pages":[{"title":"Create Order","deprecated":false,"version":null,"openapi":"/openapi.yml post /api/v2/orders","href":"/api-reference/orders/create-order"},{"title":"Query Order","deprecated":false,"version":null,"openapi":"/openapi.yml get /api/v2/orders/{orderId}","href":"/api-reference/orders/query-order"},{"title":"Cancel Order","deprecated":false,"version":null,"openapi":"/openapi.yml delete /api/v2/orders/{orderId}","href":"/api-reference/orders/cancel-order"}]},{"group":"Tokenization","pages":[{"title":"Get Token by reference","description":"Get created tokens by aggregated reference","deprecated":false,"version":null,"openapi":"/openapi.yml get /api/v2/tokens","href":"/api-reference/tokenization/get-token-by-reference"},{"title":"Create Token","deprecated":false,"version":null,"openapi":"/openapi.yml post /api/v2/tokens","href":"/api-reference/tokenization/create-token"},{"title":"Get Token By Id","description":"Get a created token By Id","deprecated":false,"version":null,"openapi":"/openapi.yml get /api/v2/tokens/{tokenId}","href":"/api-reference/tokenization/get-token-by-id"}]}]},{"group":"Settlements API","pages":[{"group":"Settlement files","pages":[{"title":"List settlement files","deprecated":null,"version":null,"openapi":"/settlements-api.yml get /api/v1/SettlementFiles","href":"/api-reference/settlement-files/list-settlement-files"}]}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Create Token - Paybyrd","buildId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","deploymentId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DCDCdBVX.js","utils-ME8dDnLe.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-0e84ACsd.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-wgRBj-ia.js","snippetPresets-C11Sgb-o.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-C0lapOpP.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-ZeRQV8fF.js","shallow-BupWh095.js","getApiPlaygroundDisplay-BnYQO2Ss.js","CodeSnippet-RKKOc8c_.js","CodeSnippets-Drf_m8wS.js","Page-Bevw23-4.js","getPastedJson-u6QiPzNZ.js","icon-Bb-CBSxO.js","MethodPill-F7l5AI7V.js","DuplicateIcon-IiAXkdSg.js","createIcon-FliI8EBc.js","DynamicMarkdown-B62XqCSI.js","SectionHeading-Dj31pT03.js","axios-vUo_bRtp.js","Markdown-BOgQCTwD.js","clsx-BIWXJmsZ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DKZWslLH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-UDqbR6xh.js"]}