{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Truust","colors":{"primary":"#073963","light":"#058ed8","dark":"#073963"},"logo":{"light":"https://mintcdn.com/socialpay/eRLQ9ToOrOIOj92q/assets/logo-truust.png?fit=max\u0026auto=format\u0026n=eRLQ9ToOrOIOj92q\u0026q=85\u0026s=1952722bf3c061af44d2195d279d6953","dark":"https://mintcdn.com/socialpay/eRLQ9ToOrOIOj92q/assets/logo-truust.png?fit=max\u0026auto=format\u0026n=eRLQ9ToOrOIOj92q\u0026q=85\u0026s=1952722bf3c061af44d2195d279d6953","href":"https://truust.io"},"favicon":"https://mintcdn.com/socialpay/eRLQ9ToOrOIOj92q/assets/logo-truust.png?fit=max\u0026auto=format\u0026n=eRLQ9ToOrOIOj92q\u0026q=85\u0026s=1952722bf3c061af44d2195d279d6953","navbar":{"links":[{"href":"https://truust.io","label":"Truust Website"},{"href":"https://truust.io/contact/","label":"Contact Us"}]},"footer":{"socials":{"website":"https://truust.io"}},"contextual":{"options":["copy","chatgpt","claude","perplexity","grok","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Dashboard","icon":"chart-line","href":"http://dashboard-sandbox.truust.io"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"socialpay","hasAudioNarration":false,"actualSubdomain":"socialpay","customDomains":["docs.truust.io"],"gitSource":{"type":"github","owner":"truust-io","repo":"docs.truust.io","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae89a23f8e61e223f91fd82","clientVersion":"0.0.4117","searchFilterCounts":[{"language":"default","tag":"API Reference","count":146},{"language":"default","tag":"Customers","count":13},{"language":"default","tag":"Orders","count":11},{"language":"default","tag":"Verifications","count":10},{"language":"default","tag":"Documentation","count":8},{"language":"default","tag":"Payins","count":7},{"language":"default","tag":"Bundles","count":6},{"language":"default","tag":"Account","count":5},{"language":"default","tag":"Wallets","count":5},{"language":"default","tag":"Platform","count":5}]},"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":"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":"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":"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}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"table td:first-child code{white-space:nowrap}"}],"page":{"pagePath":"api-reference/create-subscription","slug":"/api-reference/create-subscription","pageMetadata":{"title":"Create Subscription","openapi":"POST /subscriptions","description":"Creates a recurring payment subscription. The first order is created immediately;\nsubsequent orders are triggered on the defined schedule.\n","href":"/api-reference/create-subscription"},"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: \"Creates a recurring payment subscription. The first order is created immediately;\\nsubsequent orders are triggered on the defined schedule.\"\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 Subscription","openapi":"POST /subscriptions","description":"Creates a recurring payment subscription. The first order is created immediately;\nsubsequent orders are triggered on the defined schedule.\n","href":"/api-reference/create-subscription"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create subscription","description":"Creates a recurring payment subscription. The first order is created immediately;\nsubsequent orders are triggered on the defined schedule.\n","operationId":"createSubscription","tags":["Subscriptions"],"requestBody":"3e010296-8946-442d-84ac-dd24f69ff896","responses":{"200":"7b04af03-5bea-49da-b74f-eea5f54ee40e","422":"46965d59-831f-42d0-9e07-9cf194302e6b"},"method":"post","type":"path","servers":["0f42c800-8246-4ac3-9108-23b6b071ae36","82d02f21-f641-4af8-8110-3ba7289f1338"],"security":["ba798aec-ece0-4b40-af38-d7b7451a8091"],"path":"/subscriptions","baseUrlOptions":["https://{subdomain}.truust.io/2.0","https://{subdomain}-sandbox.truust.io/2.0"],"title":"Create subscription","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["buyer_id","seller_id","name","value","type"],"example":{"buyer_id":7485,"seller_id":7485,"name":"Subscription Test","value":10,"type":"ADDON"},"properties":{"buyer_id":{"type":"integer","description":"Customer ID of the subscriber (buyer).","example":42,"isRequired":true,"uniqueKey":"buyer_id","typeLabel":"integer"},"seller_id":{"type":"integer","description":"Customer ID of the seller.","isRequired":true,"uniqueKey":"seller_id","typeLabel":"integer"},"name":{"type":"string","maxLength":120,"example":"Monthly plan","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"value":{"type":"number","minimum":0,"description":"Recurring charge amount.","example":9.99,"isRequired":true,"uniqueKey":"value","typeLabel":"number"},"type":{"type":"string","description":"Payment method type for the subscription (e.g. `CARD`).","example":"CARD","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"fee_value":{"type":"number","minimum":0,"uniqueKey":"fee_value","typeLabel":"number"},"fee_percent":{"type":"number","minimum":0,"maximum":100,"uniqueKey":"fee_percent","typeLabel":"number"},"start_date":{"type":"string","format":"date","description":"Date when the subscription starts. Defaults to creation date if not provided.","uniqueKey":"start_date","typeLabel":"string\u003cdate>"},"first_payment_value":{"type":"number","description":"Amount for the first payment if different from `value`.","uniqueKey":"first_payment_value","typeLabel":"number"},"times":{"type":"integer","description":"Number of billing cycles. Leave null for indefinite.","uniqueKey":"times","typeLabel":"integer"},"schedule":{"type":"string","description":"Cron expression or schedule descriptor (e.g. `monthly`, `weekly`).","uniqueKey":"schedule","typeLabel":"string"},"auto_settle":{"type":"boolean","uniqueKey":"auto_settle","typeLabel":"boolean"},"tag":{"type":"string","maxLength":100,"uniqueKey":"tag","typeLabel":"string"},"metadata":{"type":"object","additionalProperties":true,"uniqueKey":"metadata","typeLabel":"object"},"order_metadata":{"type":"object","additionalProperties":true,"description":"Metadata applied to each generated order.","uniqueKey":"order_metadata","typeLabel":"object"},"buyer_confirmed_url":{"type":"string","format":"uri","uniqueKey":"buyer_confirmed_url","typeLabel":"string\u003curi>"},"buyer_denied_url":{"type":"string","format":"uri","uniqueKey":"buyer_denied_url","typeLabel":"string\u003curi>"},"seller_confirmed_url":{"type":"string","format":"uri","uniqueKey":"seller_confirmed_url","typeLabel":"string\u003curi>"},"seller_denied_url":{"type":"string","format":"uri","uniqueKey":"seller_denied_url","typeLabel":"string\u003curi>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"buyer_id":7485,"seller_id":7485,"name":"Subscription Test","value":10,"type":"ADDON"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"7b04af03-5bea-49da-b74f-eea5f54ee40e":{"description":"Subscription created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","uniqueKey":"id","typeLabel":"integer"},"self":{"type":"string","uniqueKey":"self","typeLabel":"string"},"reference_id":{"oneOf":[{"type":"string","uniqueKey":"reference_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"reference_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"reference_id","typeLabel":"string | null"},"name":{"type":"string","uniqueKey":"name","typeLabel":"string"},"amount":{"type":"number","uniqueKey":"amount","typeLabel":"number"},"currency":{"type":"string","example":"EUR","uniqueKey":"currency","typeLabel":"string"},"type":{"type":"string","description":"Payment method type for this subscription.","uniqueKey":"type","typeLabel":"string"},"status":{"type":"string","enum":["CREATED","ACTIVE","CANCELLED","EXPIRED"],"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"metadata":{"oneOf":[{"type":"object","additionalProperties":true,"uniqueKey":"metadata.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"uniqueKey":"metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"metadata","typeLabel":"object | null"},"published_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"published_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"published_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"published_at","typeLabel":"string\u003cdate-time> | null"},"cancelled_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"cancelled_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"cancelled_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"cancelled_at","typeLabel":"string\u003cdate-time> | null"},"connections":{"type":"object","description":"Hypermedia links to related resources.","additionalProperties":{"type":"string","uniqueKey":"connections.additionalProperties","typeLabel":"string"},"uniqueKey":"connections","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":123,"self":"\u003cstring>","reference_id":"\u003cstring>","name":"\u003cstring>","amount":123,"currency":"EUR","type":"\u003cstring>","status":"CREATED","metadata":{},"published_at":"2023-11-07T05:31:56Z","cancelled_at":"2023-11-07T05:31:56Z","connections":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"46965d59-831f-42d0-9e07-9cf194302e6b":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"The given data was invalid.","uniqueKey":"message","typeLabel":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"errors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors.additionalProperties","typeLabel":"string[]"},"example":{"name":["The name field is required."]},"uniqueKey":"errors","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"The given data was invalid.","errors":{"name":["The name field is required."]}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"ba798aec-ece0-4b40-af38-d7b7451a8091":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Use your account's **Secret Key** as the Bearer token.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"0f42c800-8246-4ac3-9108-23b6b071ae36":{"url":"https://{subdomain}.truust.io/2.0","description":"Production","variables":{"subdomain":{"default":"your-subdomain","description":"Your account subdomain"}}},"82d02f21-f641-4af8-8110-3ba7289f1338":{"url":"https://{subdomain}-sandbox.truust.io/2.0","description":"Sandbox","variables":{"subdomain":{"default":"your-subdomain","description":"Your account subdomain"}}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Use your account's **Secret Key** as the Bearer token.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Use your account's **Secret Key** as the Bearer token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"socialpay","siteName":"Truust","title":"Create Subscription - Truust","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-12T07:06:50.177Z","originalFileLocation":"api-reference/create-subscription.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=\"Creates a recurring payment subscription. The first order is created immediately; subsequent orders are triggered on the defined schedule.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Truust\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/socialpay/iG2BZRyj_cp1_SCh/_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/socialpay/iG2BZRyj_cp1_SCh/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/socialpay/iG2BZRyj_cp1_SCh/_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/socialpay/iG2BZRyj_cp1_SCh/_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/socialpay/iG2BZRyj_cp1_SCh/_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/socialpay/iG2BZRyj_cp1_SCh/_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/socialpay/iG2BZRyj_cp1_SCh/_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/socialpay/iG2BZRyj_cp1_SCh/_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/socialpay/iG2BZRyj_cp1_SCh/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Subscription - Truust\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a recurring payment subscription. The first order is created immediately; subsequent orders are triggered on the defined schedule.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Truust\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.truust.io/api-reference/create-subscription\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://socialpay.mintlify.site/_mintlify/api/og/v2?division=Subscriptions\u0026amp;title=Create+Subscription\u0026amp;description=Creates+a+recurring+payment+subscription.+The+first+order+is+created+immediately%3B%0Asubsequent+orders+are+triggered+on+the+defined+schedule.%0A\u0026amp;theme=07ebb1876c42192d9d839b55\u0026amp;signature=37890363da001b0f7db6c3884e3ef88a75f7f9066bd6c347364eb9ad5c266e02\">\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 Subscription - Truust\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a recurring payment subscription. The first order is created immediately; subsequent orders are triggered on the defined schedule.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://socialpay.mintlify.site/_mintlify/api/og/v2?division=Subscriptions\u0026amp;title=Create+Subscription\u0026amp;description=Creates+a+recurring+payment+subscription.+The+first+order+is+created+immediately%3B%0Asubsequent+orders+are+triggered+on+the+defined+schedule.%0A\u0026amp;theme=07ebb1876c42192d9d839b55\u0026amp;signature=37890363da001b0f7db6c3884e3ef88a75f7f9066bd6c347364eb9ad5c266e02\">\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/socialpay/iG2BZRyj_cp1_SCh/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Truust\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#073963\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.truust.io/api-reference/create-subscription\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/create-subscription.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.truust.io/#organization\",\"name\":\"Truust\",\"url\":\"https://docs.truust.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/socialpay/eRLQ9ToOrOIOj92q/assets/logo-truust.png?fit=max\u0026auto=format\u0026n=eRLQ9ToOrOIOj92q\u0026q=85\u0026s=1952722bf3c061af44d2195d279d6953\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.truust.io#website\",\"name\":\"Truust\",\"url\":\"https://docs.truust.io\",\"publisher\":{\"@id\":\"https://docs.truust.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.truust.io/api-reference/create-subscription#webpage\",\"url\":\"https://docs.truust.io/api-reference/create-subscription\",\"name\":\"Create Subscription\",\"description\":\"Creates a recurring payment subscription. The first order is created immediately; subsequent orders are triggered on the defined schedule.\",\"dateModified\":\"2026-03-12T07:06:50.177Z\",\"isPartOf\":{\"@id\":\"https://docs.truust.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.truust.io/api-reference/create-subscription#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.truust.io/api-reference/create-subscription#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.truust.io/api-reference\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Subscriptions\",\"item\":\"https://docs.truust.io/api-reference/list-subscriptions\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create Subscription\",\"item\":\"https://docs.truust.io/api-reference/create-subscription\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.truust.io/api-reference/create-subscription#apireference\",\"headline\":\"Create Subscription\",\"name\":\"Create Subscription\",\"description\":\"Creates a recurring payment subscription. The first order is created immediately; subsequent orders are triggered on the defined schedule.\",\"url\":\"https://docs.truust.io/api-reference/create-subscription\",\"mainEntityOfPage\":{\"@id\":\"https://docs.truust.io/api-reference/create-subscription#webpage\"},\"dateModified\":\"2026-03-12T07:06:50.177Z\",\"publisher\":{\"@id\":\"https://docs.truust.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.truust.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Truust\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Truust\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/create-subscription.md","siteName":"Truust","nav":{"global":{"anchors":[{"anchor":"Dashboard","icon":"chart-line","href":"http://dashboard-sandbox.truust.io"}]},"anchors":[{"anchor":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/introduction"}]},{"anchor":"API Reference","icon":"code","groups":[{"group":"API Reference","pages":[{"title":"API Reference","href":"/api-reference"},{"group":"Account","pages":[{"title":"Get Current Account","openapi":"GET /accounts/me","href":"/api-reference/get-account"},{"title":"Update Account","openapi":"PUT /accounts/me","href":"/api-reference/update-account"},{"title":"Create Account","openapi":"POST /accounts","href":"/api-reference/create-account"},{"title":"Get Account Fees","openapi":"GET /accounts/fees/{currency}","href":"/api-reference/get-account-fees"},{"title":"Verify Account","openapi":"POST /accounts/verify","href":"/api-reference/verify-account"}]},{"group":"Customers","pages":[{"title":"List Customers","openapi":"GET /customers","href":"/api-reference/list-customers"},{"title":"Create Customer","openapi":"POST /customers","href":"/api-reference/create-customer"},{"title":"Get Customer","openapi":"GET /customers/{uuid}","href":"/api-reference/get-customer"},{"title":"Update Customer","openapi":"PUT /customers/{uuid}","href":"/api-reference/update-customer"},{"title":"List Customer Wallets","openapi":"GET /customers/{uuid}/wallets","href":"/api-reference/list-customer-wallets"},{"title":"List Customer Cards","openapi":"GET /customers/{uuid}/cards","href":"/api-reference/list-customer-cards"},{"title":"Add Card to Customer","openapi":"POST /customers/{uuid}/cards","href":"/api-reference/create-card"},{"title":"List Customer Bank Accounts","openapi":"GET /customers/{uuid}/bankaccounts","href":"/api-reference/list-customer-bank-accounts"},{"title":"List Customer Addresses","openapi":"GET /customers/{uuid}/addresses","href":"/api-reference/list-customer-addresses"},{"title":"Add Address to Customer","openapi":"POST /customers/{uuid}/addresses","href":"/api-reference/create-customer-address"},{"title":"Get Customer Address","openapi":"GET /customers/{uuid}/addresses/{address_uuid}","href":"/api-reference/get-customer-address"},{"title":"Update Customer Address","openapi":"PUT /customers/{uuid}/addresses/{address_uuid}","href":"/api-reference/update-customer-address"},{"title":"List Customer Subscriptions","openapi":"GET /customers/{uuid}/subscriptions","href":"/api-reference/list-customer-subscriptions"}]},{"group":"Orders","pages":[{"title":"List Orders","openapi":"GET /orders","href":"/api-reference/list-orders"},{"title":"Create Order","openapi":"POST /orders","href":"/api-reference/create-order"},{"title":"Get Order","openapi":"GET /orders/{id}","href":"/api-reference/get-order"},{"title":"Update Order","openapi":"PUT /orders/{id}","href":"/api-reference/update-order"},{"title":"Get Order Payin","openapi":"GET /orders/{id}/payin","href":"/api-reference/get-order-payin"},{"title":"Get Order Payout","openapi":"GET /orders/{id}/payout","href":"/api-reference/get-order-payout"},{"title":"Accept Order","openapi":"POST /orders/{id}/accept","href":"/api-reference/accept-order"},{"title":"Cancel Order","openapi":"POST /orders/{id}/cancel","href":"/api-reference/cancel-order"},{"title":"Validate Order","openapi":"POST /orders/{id}/validate","href":"/api-reference/validate-order"},{"title":"Send Order Receipt","openapi":"POST /orders/{id}/receipt","href":"/api-reference/send-order-receipt"},{"title":"Reimburse Order","openapi":"POST /orders/{id}/reimburse","href":"/api-reference/reimburse-order"}]},{"group":"Payins","pages":[{"title":"List Payins","openapi":"GET /payins","href":"/api-reference/list-payins"},{"title":"Create Payin","openapi":"POST /payins","href":"/api-reference/create-payin"},{"title":"Get Payin","openapi":"GET /payins/{id}","href":"/api-reference/get-payin"},{"title":"Sync Payin Status","openapi":"PUT /payins/{id}","href":"/api-reference/sync-payin"},{"title":"Refund Payin","openapi":"POST /payins/{id}/refund","href":"/api-reference/refund-payin"},{"title":"Cancel Pre-Authorization","openapi":"POST /payins/{id}/cancelpreauth","href":"/api-reference/cancel-pre-auth"},{"title":"Request to Pay","openapi":"POST /payins/{id}/request","href":"/api-reference/request-to-pay"}]},{"group":"Payouts","pages":[{"title":"List Payouts","openapi":"GET /payouts","href":"/api-reference/list-payouts"},{"title":"Create Payout","openapi":"POST /payouts","href":"/api-reference/create-payout"},{"title":"Get Payout","openapi":"GET /payouts/{id}","href":"/api-reference/get-payout"},{"title":"Sync Payout Status","openapi":"POST /payouts/{id}/update","href":"/api-reference/sync-payout"}]},{"group":"Wallets","pages":[{"title":"List Wallets","openapi":"GET /wallets","href":"/api-reference/list-wallets"},{"title":"Create Wallet","openapi":"POST /wallets","href":"/api-reference/create-wallet"},{"title":"Get Wallet","openapi":"GET /wallets/{uuid}","href":"/api-reference/get-wallet"},{"title":"Update Wallet","openapi":"PUT /wallets/{uuid}","href":"/api-reference/update-wallet"},{"title":"List Wallet Transactions","openapi":"GET /wallets/{uuid}/transactions","href":"/api-reference/list-wallet-transactions"}]},{"group":"Bank Accounts","pages":[{"title":"Create Bank Account","openapi":"POST /bankaccounts","href":"/api-reference/create-bank-account"},{"title":"Get Bank Account","openapi":"GET /bankaccounts/{uuid}","href":"/api-reference/get-bank-account"},{"title":"Get Bank Account Validation","openapi":"GET /bankaccounts/validation","href":"/api-reference/get-bank-account-validation"}]},{"group":"Cards","pages":[{"title":"Get Card","openapi":"GET /cards/{uuid}","href":"/api-reference/get-card"},{"title":"Delete Card","openapi":"DELETE /cards/{uuid}","href":"/api-reference/delete-card"}]},{"group":"Subscriptions","pages":[{"title":"List Subscriptions","openapi":"GET /subscriptions","description":null,"href":"/api-reference/list-subscriptions"},{"title":"Create Subscription","openapi":"POST /subscriptions","href":"/api-reference/create-subscription"},{"title":"Get Subscription","openapi":"GET /subscriptions/{id}","description":null,"href":"/api-reference/get-subscription"},{"title":"Cancel Subscription","openapi":"PUT /subscriptions/{id}/cancel","href":"/api-reference/cancel-subscription"}]},{"group":"Verifications","pages":[{"title":"List Verifications","openapi":"GET /verifications","href":"/api-reference/list-verifications"},{"title":"Get Verification","openapi":"GET /verifications/{uuid}","href":"/api-reference/get-verification"},{"title":"Submit Verification (KYC)","openapi":"PUT /verifications/{uuid}","href":"/api-reference/submit-verification"},{"title":"Request Verification Review","openapi":"POST /verifications/{uuid}/request","href":"/api-reference/request-verification"},{"title":"Create KYC for a Customer","openapi":"POST /customers/{uuid}/verify","href":"/api-reference/create-customer-verification"},{"title":"Get KYC Verification for a Customer","openapi":"GET /customers/{uuid}/verification","href":"/api-reference/get-customer-verification"},{"title":"List Verification Documents","openapi":"GET /verifications/{uuid}/documents","href":"/api-reference/list-verification-documents"},{"title":"Upload Verification Document","openapi":"POST /verifications/{uuid}/documents","href":"/api-reference/upload-verification-document"},{"title":"Get Verification Document","openapi":"GET /verifications/{uuid}/documents/{document_uuid}","href":"/api-reference/get-verification-document"},{"title":"Update Verification Document","openapi":"PUT /verifications/{uuid}/documents/{document_uuid}","href":"/api-reference/update-verification-document"}]},{"group":"Bundles","pages":[{"title":"List Bundles","openapi":"GET /bundles","href":"/api-reference/list-bundles"},{"title":"Create Bundle","openapi":"POST /bundles","href":"/api-reference/create-bundle"},{"title":"List Expired Bundles","openapi":"GET /bundles/expired","href":"/api-reference/list-expired-bundles"},{"title":"Get Bundle","openapi":"GET /bundles/{bundle_id}","href":"/api-reference/get-bundle"},{"title":"Update Bundle","openapi":"PUT /bundles/{bundle_id}","href":"/api-reference/update-bundle"},{"title":"List Orders for a Bundle","openapi":"GET /bundles/{bundle_id}/orders","href":"/api-reference/list-bundle-orders"}]},{"group":"Refunds","pages":[{"title":"List Refunds","openapi":"GET /refunds","href":"/api-reference/list-refunds"},{"title":"Get Refund","openapi":"GET /refunds/{id}","href":"/api-reference/get-refund"}]}]}]}]},"basePath":"","title":"Create Subscription - Truust","buildId":"dpl_41S5Z2jG9QnfDRwN1KZrLdBwj7DM","deploymentId":"dpl_41S5Z2jG9QnfDRwN1KZrLdBwj7DM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DDP9JXtj.js","utils-8yQyvEtx.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CBCFR8Sn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-rQaXkUHa.js","snippetPresets-J5KpBTgV.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BVxVH4Cj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BxdQ2vIi.js","shallow-BjV2tFiD.js","getApiPlaygroundDisplay-C_55tL4O.js","CodeSnippet-C0JpiCOC.js","CodeSnippets-w9Ps7djG.js","Page-DTNSD-0M.js","getPastedJson-BDfB-H8d.js","icon-g-kUkkO9.js","MethodPill-v4l6fq0h.js","DuplicateIcon-CvLo-CfU.js","createIcon-165clrrV.js","DynamicMarkdown-D3RQ-fEj.js","SectionHeading-vvo-3yLf.js","axios-vUo_bRtp.js","Markdown-CMT1uFWQ.js","clsx-C8f2yC9R.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CI2D8R2Y.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-k78Wrw_e.js"]}