Opens a payment link by creating a brand-new checkout session for it and returning the gateway URL to send the payer to. Each call mints an independent payment — call it once per payer.
checkout_url comes back relative (/gateway?payment_id=...) so links work on any host. Prepend your site origin before redirecting — e.g. https://tribridge.xyz + /gateway?payment_id=....
amount is required: 400 A valid amount is required for this payment link.
Amount below $0.50
400 Minimum payment amount is $0.50.
email / name provided
Stored on the payment so receipts work out of the box.
Link deactivated after lookup
410 This payment link has been deactivated.
The created payment inherits the link’s mode (is_test), currency, pinned chain + coin_symbol, description, and processing-fee flag — all configured on the link in your dashboard.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Tribridge","description":"Accept Solana and Sui crypto payments with one API. Automatic settlement, real-time webhooks, and a 5-minute integration.","colors":{"primary":"#2b6bff","light":"#FFFFFF","dark":"#2b6bff"},"logo":{"light":"https://mintcdn.com/tribridge/ez2qRTSP_I_EOQfC/logo/light.png?fit=max\u0026auto=format\u0026n=ez2qRTSP_I_EOQfC\u0026q=85\u0026s=b6c9747d6d25b7a8ba7e0cd287ad77f8","dark":"https://mintcdn.com/tribridge/ez2qRTSP_I_EOQfC/logo/dark.png?fit=max\u0026auto=format\u0026n=ez2qRTSP_I_EOQfC\u0026q=85\u0026s=32ad49372b5511e70f36739733fdc3a1"},"favicon":"https://mintcdn.com/tribridge/ez2qRTSP_I_EOQfC/favicon.png?fit=max\u0026auto=format\u0026n=ez2qRTSP_I_EOQfC\u0026q=85\u0026s=288cf39ffc8ee7bdb7888bda4136d268","api":{"openapi":["openapi/openapi.json"],"mdx":{"auth":{"method":"key","name":"x-api-key"},"server":"https://api.tribridge.xyz"}},"appearance":{"default":"system"},"navbar":{"links":[{"href":"https://calendly.com/worgubelieve/30min","label":"Book a Demo"},{"href":"https://tribridge.xyz/overview","label":"Dashboard"}],"primary":{"type":"button","label":"Get started","href":"https://tribridge.xyz/signup"}},"footer":{"socials":{"x":"https://x.com/usetribridge","github":"https://github.com/usetribridge","linkedin":"https://linkedin.com/company/usetribridge"}},"fonts":{"family":"Inter"},"icons":{"library":"lucide"},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"markdown":{"instructions":"Tribridge is a crypto payment gateway for Solana and Sui (TON is coming soon). API base URL is https://api.tribridge.xyz. The API Reference documents ONLY the public endpoint surface: checkout sessions (create/get/generate-wallet/customer/simulate/verify/cancel), the two public payment-link endpoints, health probes, and the changelog. Server-side calls that create payments authenticate with the x-api-key header using a tri_test_... key (fully simulated test mode, no real funds) or tri_live_... key (real mainnet payments) - never expose keys client-side; all other documented endpoints are public with no auth. Dashboard, admin, OTP/auth, payouts, wallets, and webhook-management endpoints are intentionally NOT part of the public docs - they are dashboard-only and must not be presented as public API. Merchant test mode is simulated, not testnet. Refunds are automatic only (underpaid/overpaid), there is no manual refund endpoint. Always verify webhook HMAC-SHA256 signatures from the X-Tribridge-Signature header before trusting payloads. If you are an AI agent: fetch https://docs.tribridge.xyz/llms-full.txt for all documentation in one file, https://docs.tribridge.xyz/openapi/openapi.json for the machine-readable OpenAPI spec, or connect to the read-only MCP server at https://docs.tribridge.xyz/mcp. Any page is available as Markdown by appending .md to its URL. Use only the documented endpoints and fields; do not invent SDK packages or endpoints."},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tribridge","hasAudioNarration":false,"actualSubdomain":"tribridge","customDomains":["docs.tribridge.xyz"],"gitSource":{"type":"github","owner":"code-ninjax","repo":"tribridge","deployBranch":"main","contentDirectory":"tribridge-docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6adcb8ada22308d93b4ea553","collectionId":"4b2dc334-4ed9-46e5-83b1-d49df8917450","liveDeploymentHistoryId":"6adcb8ada22308d93b4ea553","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6adcb8ada22308d93b4ea553","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"API Reference","count":17},{"language":"default","tag":"Guides","count":9},{"language":"default","tag":"Checkout Sessions","count":7},{"language":"default","tag":"Get Started","count":5},{"language":"default","tag":"Core Concepts","count":4},{"language":"default","tag":"Payment Links","count":3},{"language":"default","tag":"Developers","count":3},{"language":"default","tag":"Status","count":2},{"language":"default","tag":"Webhooks \u0026 Refunds","count":2}]},"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":"editor-v7-file-tree","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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"editor-agent-model-picker","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"create-link-checkout","slug":"/create-link-checkout","pageMetadata":{"title":"Create a checkout from a payment link","description":"Materialize a fresh checkout session for a payment link and get its gateway URL. No API key.","openapi":"POST /payment-links/public/{slug}/checkout","href":"/create-link-checkout"},"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: \"Materialize a fresh checkout session for a payment link and get its gateway URL. No API key.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Opens a payment link by creating a `,_jsx(_components.strong,{children:`brand-new`}),` checkout session for it and returning the gateway URL to send the payer to. Each call mints an independent payment — call it once per payer.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`checkout_url`}),` comes back `,_jsx(_components.strong,{children:`relative`}),` (`,_jsx(_components.code,{children:`/gateway?payment_id=...`}),`) so links work on any host. Prepend your site origin before redirecting — e.g. `,_jsx(_components.code,{children:`https://tribridge.xyz`}),` + `,_jsx(_components.code,{children:`/gateway?payment_id=...`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`request-rules`,children:`Request rules`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Situation`}),_jsx(_components.th,{children:`Behavior`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Fixed-amount link`}),_jsxs(_components.td,{children:[`Omit `,_jsx(_components.code,{children:`amount`}),` — the link’s amount is used.`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Custom-amount link (`,_jsx(_components.code,{children:`allow_custom_amount`}),`)`]}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`amount`}),` is `,_jsx(_components.strong,{children:`required`}),`: `,_jsx(_components.code,{children:`400 A valid amount is required for this payment link`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Amount below $0.50`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`400 Minimum payment amount is $0.50`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`email`}),` / `,_jsx(_components.code,{children:`name`}),` provided`]}),_jsx(_components.td,{children:`Stored on the payment so receipts work out of the box.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Link deactivated after lookup`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`410 This payment link has been deactivated`}),`.`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`The created payment inherits the link’s mode (`,_jsx(_components.code,{children:`is_test`}),`), currency, pinned `,_jsx(_components.code,{children:`chain`}),` + `,_jsx(_components.code,{children:`coin_symbol`}),`, description, and processing-fee flag — all configured on the link in your dashboard.`]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(CodeBlock,{filename:`201 Created`,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"payment_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"c4a9e2b7-5f1d-4c83-8e6a-9b0d3f7a1c2e\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"checkout_url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"/gateway?payment_id=c4a9e2b7-5f1d-4c83-8e6a-9b0d3f7a1c2e\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`25`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"currency\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"USDC\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"is_test\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`From there it’s the normal flow: `,_jsx(_components.a,{href:`/get-checkout-session`,children:`Get checkout session`}),` for status, `,_jsx(_components.a,{href:`/verify-payment`,children:`Verify payment`}),` for a manual re-check, and `,_jsx(_components.a,{href:`/webhooks`,children:`Webhooks`}),` for fulfillment.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create a checkout from a payment link","description":"Materialize a fresh checkout session for a payment link and get its gateway URL. No API key.","openapi":"POST /payment-links/public/{slug}/checkout","href":"/create-link-checkout"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Request rules","slug":"request-rules","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Payment Links"],"summary":"Create a checkout from a payment link","operationId":"checkoutPaymentLink","description":"Materialize a fresh checkout session for a payment link and get its gateway URL. No API key.","parameters":["e3757abe-a6d2-435d-ac54-dfb25c4acf9e"],"requestBody":"ece6bca4-ce05-4410-91cb-5dcce62da289","responses":{"201":"1bbecca5-a279-4793-a24b-1cf6651d0306","400":"657cb63c-80b2-4ae6-adfc-744c4381b29a","404":"1e497382-2f1a-48e1-92a1-46fa57843da6","410":"ef2fff48-129b-4c15-989e-3c772d49ede3"},"method":"post","type":"path","servers":["b987a922-a93b-4850-a879-013b5980daa8"],"security":[],"path":"/payment-links/public/{slug}/checkout","baseUrlOptions":["https://api.tribridge.xyz"],"title":"Create a checkout from a payment link","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"e3757abe-a6d2-435d-ac54-dfb25c4acf9e":{"name":"slug","in":"path","required":true,"schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"},"example":"acme-coffee-9f3a"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"amount":{"type":"number","minimum":0.5,"example":25,"description":"Required when the link allows a custom amount; ignored for fixed-amount links. Minimum **$0.50**.","uniqueKey":"amount","typeLabel":"number"},"email":{"type":"string","format":"email","example":"jane@example.com","description":"Payer email, stored on the payment for receipts.","uniqueKey":"email","typeLabel":"string\u003cemail>"},"name":{"type":"string","example":"Jane Doe","description":"Payer name.","uniqueKey":"name","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"amount":25,"email":"jane@example.com","name":"Jane Doe"},"examples":{"Example":{"title":"Example","value":{"amount":25,"email":"jane@example.com","name":"Jane Doe"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"1bbecca5-a279-4793-a24b-1cf6651d0306":{"description":"Checkout session created from the link","content":{"application/json":{"examples":{"created":{"title":"created","value":{"payment_id":"c4a9e2b7-5f1d-4c83-8e6a-9b0d3f7a1c2e","checkout_url":"/gateway?payment_id=c4a9e2b7-5f1d-4c83-8e6a-9b0d3f7a1c2e","amount":25,"currency":"USDC","is_test":true}}},"exampleType":"examples"}},"exampleType":"examples"},"657cb63c-80b2-4ae6-adfc-744c4381b29a":{"description":"Missing custom amount, no amount configured, or below minimum","content":{"application/json":{"examples":{"customRequired":{"title":"customRequired","value":{"error":"A valid amount is required for this payment link"}},"noAmount":{"title":"noAmount","value":{"error":"This payment link has no amount configured"}},"tooSmall":{"title":"tooSmall","value":{"error":"Minimum payment amount is $0.50"}}},"exampleType":"examples"}},"exampleType":"examples"},"1e497382-2f1a-48e1-92a1-46fa57843da6":{"description":"Unknown slug","content":{"application/json":{"example":{"error":"Payment link not found"},"examples":{"Example":{"title":"Example","value":{"error":"Payment link not found"}}},"exampleType":"examples"}},"exampleType":"examples"},"ef2fff48-129b-4c15-989e-3c772d49ede3":{"description":"Link deactivated","content":{"application/json":{"example":{"error":"This payment link has been deactivated"},"examples":{"Example":{"title":"Example","value":{"error":"This payment link has been deactivated"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"87a9be42-0b6c-4ce0-812e-2cfebdfdb2f9":{"Key":{"name":"x-api-key","type":"apiKey","in":"header"}}},"servers":{"b987a922-a93b-4850-a879-013b5980daa8":{"url":"https://api.tribridge.xyz"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"name":"x-api-key","type":"apiKey","in":"header"},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"Key","name":"x-api-key"}],"title":"Key"}]},"originalFileLocation":"openapi/openapi.json"},"subdomain":"tribridge","siteName":"Tribridge","title":"Create a checkout from a payment link - Tribridge","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-08T13:24:53.219Z","originalFileLocation":"create-link-checkout.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=\"Materialize a fresh checkout session for a payment link and get its gateway URL. No API key.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Tribridge\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tribridge/8G7qooEnVr7Gok2Z/_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/tribridge/8G7qooEnVr7Gok2Z/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tribridge/8G7qooEnVr7Gok2Z/_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/tribridge/8G7qooEnVr7Gok2Z/_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/tribridge/8G7qooEnVr7Gok2Z/_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/tribridge/8G7qooEnVr7Gok2Z/_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/tribridge/8G7qooEnVr7Gok2Z/_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/tribridge/8G7qooEnVr7Gok2Z/_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/tribridge/8G7qooEnVr7Gok2Z/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a checkout from a payment link - Tribridge\">\u003cmeta data-mint-head property=\"og:description\" content=\"Materialize a fresh checkout session for a payment link and get its gateway URL. No API key.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Tribridge\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.tribridge.xyz/create-link-checkout\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tribridge.mintlify.app/_mintlify/api/og/v2?division=Payment+Links\u0026amp;title=Create+a+checkout+from+a+payment+link\u0026amp;description=Materialize+a+fresh+checkout+session+for+a+payment+link+and+get+its+gateway+URL.+No+API+key.\u0026amp;theme=fec04a2c39e554d279508825\u0026amp;signature=ca4f66d927fecf4d02c396fc4430dead02605fd24dcba2f0fc6a5e4ade8f9c06\">\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 a checkout from a payment link - Tribridge\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Materialize a fresh checkout session for a payment link and get its gateway URL. No API key.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tribridge.mintlify.app/_mintlify/api/og/v2?division=Payment+Links\u0026amp;title=Create+a+checkout+from+a+payment+link\u0026amp;description=Materialize+a+fresh+checkout+session+for+a+payment+link+and+get+its+gateway+URL.+No+API+key.\u0026amp;theme=fec04a2c39e554d279508825\u0026amp;signature=ca4f66d927fecf4d02c396fc4430dead02605fd24dcba2f0fc6a5e4ade8f9c06\">\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/tribridge/8G7qooEnVr7Gok2Z/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Tribridge\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2b6bff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.tribridge.xyz/create-link-checkout\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/create-link-checkout.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.tribridge.xyz/#organization\",\"name\":\"Tribridge\",\"url\":\"https://docs.tribridge.xyz\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tribridge/ez2qRTSP_I_EOQfC/logo/light.png?fit=max\u0026auto=format\u0026n=ez2qRTSP_I_EOQfC\u0026q=85\u0026s=b6c9747d6d25b7a8ba7e0cd287ad77f8\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.tribridge.xyz#website\",\"name\":\"Tribridge\",\"url\":\"https://docs.tribridge.xyz\",\"publisher\":{\"@id\":\"https://docs.tribridge.xyz/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.tribridge.xyz/create-link-checkout#webpage\",\"url\":\"https://docs.tribridge.xyz/create-link-checkout\",\"name\":\"Create a checkout from a payment link\",\"description\":\"Materialize a fresh checkout session for a payment link and get its gateway URL. No API key.\",\"dateModified\":\"2026-10-08T13:24:53.219Z\",\"isPartOf\":{\"@id\":\"https://docs.tribridge.xyz#website\"},\"breadcrumb\":{\"@id\":\"https://docs.tribridge.xyz/create-link-checkout#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.tribridge.xyz/create-link-checkout#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Payment Links\",\"item\":\"https://docs.tribridge.xyz/payment-links\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a checkout from a payment link\",\"item\":\"https://docs.tribridge.xyz/create-link-checkout\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.tribridge.xyz/create-link-checkout#apireference\",\"headline\":\"Create a checkout from a payment link\",\"name\":\"Create a checkout from a payment link\",\"description\":\"Materialize a fresh checkout session for a payment link and get its gateway URL. No API key.\",\"url\":\"https://docs.tribridge.xyz/create-link-checkout\",\"mainEntityOfPage\":{\"@id\":\"https://docs.tribridge.xyz/create-link-checkout#webpage\"},\"dateModified\":\"2026-10-08T13:24:53.219Z\",\"publisher\":{\"@id\":\"https://docs.tribridge.xyz/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.tribridge.xyz#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Tribridge\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Tribridge","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Checkout Sessions","pages":[{"title":"Create a checkout session","openapi":"POST /payments","href":"/create-checkout-session"},{"title":"Get checkout session","openapi":"GET /payments/checkout/{id}","href":"/get-checkout-session"},{"title":"Generate deposit wallet","openapi":"POST /payments/checkout/{id}/generate-wallet","href":"/generate-deposit-wallet"},{"title":"Save customer details","openapi":"POST /payments/checkout/{id}/customer","href":"/save-customer-details"},{"title":"Simulate payment","openapi":"POST /payments/checkout/{id}/simulate","href":"/simulate-payment"},{"title":"Verify payment","openapi":"POST /payments/checkout/{id}/verify","href":"/verify-payment"},{"title":"Cancel checkout session","openapi":"POST /payments/checkout/{id}/cancel","href":"/cancel-payment"}]},{"group":"Payment Links","pages":[{"title":"Payment Links","href":"/payment-links"},{"title":"Get a payment link","description":"Read the public details of an active payment link. No API key.","openapi":"GET /payment-links/public/{slug}","href":"/get-payment-link"},{"title":"Create a checkout from a payment link","openapi":"POST /payment-links/public/{slug}/checkout","href":"/create-link-checkout"}]},{"group":"Webhooks \u0026 Refunds","pages":[{"title":"Webhooks","description":"Real-time POST notifications for every payment state change, signed with HMAC-SHA256.","href":"/webhooks"},{"title":"Refunds","href":"/refunds"}]},{"group":"Status","pages":[{"title":"Health \u0026 status","openapi":"GET /health/rpc","href":"/health"},{"title":"Changelog","openapi":"GET /changelog","href":"/changelog"}]},{"group":"Developers","pages":[{"title":"SDKs \u0026 Libraries","href":"/sdks"},{"title":"Testing","href":"/testing"},{"title":"Errors","href":"/errors"}]}]}]},"title":"Create a checkout from a payment link - Tribridge","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-WRhTSUDL.js","utils-ChMov4Kr.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-_REmC2bI.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp6nVRCu.js","snippetPresets-DZadmXoU.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CY2WdoTl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DwYG-Q4l.js","shallow-BXQIGwv4.js","getApiPlaygroundDisplay-CK5nK5B9.js","CodeSnippet-TH4a2aGW.js","CodeSnippets-DwsQiOFS.js","Page-R3M_BF4L.js","getPastedJson-DD7kUzi_.js","icon-holE3QoJ.js","MethodPill-DUW0T8us.js","DuplicateIcon-CI_p4be-.js","createIcon-BdbRvavb.js","DynamicMarkdown-DN96a4Ur.js","SectionHeading-SCu36A9d.js","axios-vUo_bRtp.js","Markdown-CCeGv-zI.js","clsx-BGBGWFTt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cv_O2fky.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-2C5OB2eV.js"]}