This endpoint does not create an instruction and does not authorize spending. Use it when the user only needs to add a card. To bind a card and sign in one flow, omit payment_instrument_id in Create instruction instead. There are no body fields for choosing a customer; the session is always created for the token’s customer.Each call creates a new, independent session with a short TTL. When the user opens the link and completes the card-binding ceremony, the card is added to the customer’s payment methods (List payment methods). No instruction or authorization is created. The link can be reopened or re-exchanged while the session is still pending; it stops working once the card-binding ceremony completes or the session expires.
Treat the card-binding link as a credential. Do not forward it, screenshot it, or write it to logs; anyone who has the link can open it while it is valid and complete card binding for that customer. Deliver it only to the intended user.
Authorizations
Authorization
string
header
required
Portal user token from POST /agent/cwallet/platform/portal/tokens. Reads require portal:read; writes require portal:write.
Response
Success
code
integer<int32>
200 on success.
Example:
200
msg
string
Result message.
Example:
"Success"
data
object
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Clink Documentation","colors":{"primary":"#FF9472"},"logo":{"light":"https://mintcdn.com/clink/SmNnnZK50PsVdBCU/logo/light_new.svg?fit=max\u0026auto=format\u0026n=SmNnnZK50PsVdBCU\u0026q=85\u0026s=9956e279765b6e968dcc19748a3ee896","dark":"https://mintcdn.com/clink/SmNnnZK50PsVdBCU/logo/dark_new.svg?fit=max\u0026auto=format\u0026n=SmNnnZK50PsVdBCU\u0026q=85\u0026s=e447d25bef8f25b8da7fbbe78e04ef92"},"favicon":"https://mintcdn.com/clink/peBNaRlFWIQS8vOQ/favicon.svg?fit=max\u0026auto=format\u0026n=peBNaRlFWIQS8vOQ\u0026q=85\u0026s=c6eb5684668bd21139f01cb68bd69932","api":{"playground":{"display":"interactive"},"examples":{"languages":["curl","java","python","javascript"]}},"appearance":{"default":"light","strict":true},"navbar":{"links":[{"href":"https://uat-dashboard.clinkbill.com","label":"Sandbox"},{"href":"mailto:contact@clinkbill.com","label":"Support"},{"href":"https://github.com/clinkbillcom/clink-integ-skills","label":"Integration-skill"},{"href":"https://docs.clinkbill.com/llms.txt","label":"llms.txt"},{"href":"https://docs.clinkbill.com/llms-full.txt","label":"llms-full.txt"}],"primary":{"type":"button","label":"Dashboard","href":"https://dashboard.clinkbill.com"}},"footer":{"socials":{"x":"https://x.com/clink_bill","linkedin":"https://linkedin.com/company/clinkbill"}},"icons":{"library":"lucide"},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","href":""},{"language":"cn","href":"cn"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"clink","hasAudioNarration":false,"actualSubdomain":"clink","customDomains":["docs.clinkbill.com"],"gitSource":{"type":"github","owner":"pppatrickkkk","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6afc86ae9c831e7823345628","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"en","tag":"API Reference","count":53},{"language":"cn","tag":"API 文档","count":53},{"language":"en","tag":"Documentation","count":42},{"language":"cn","tag":"知识库","count":42},{"language":"default","tag":"API Reference","count":36},{"language":"en","tag":"Agent Portal","count":20},{"language":"cn","tag":"Agent Portal","count":20},{"language":"en","tag":"Guides","count":14},{"language":"cn","tag":"介绍","count":14},{"language":"en","tag":"Agent Solutions","count":12},{"language":"cn","tag":"Agent 解决方案","count":12},{"language":"default","tag":"Webhook Endpoint Management","count":10},{"language":"default","tag":"Webhooks","count":7},{"language":"en","tag":"Core Resource","count":6},{"language":"cn","tag":"资源说明","count":6},{"language":"en","tag":"Integration","count":5},{"language":"en","tag":"API Documentation","count":5},{"language":"en","tag":"Payment Methods","count":5},{"language":"en","tag":"Account","count":5},{"language":"default","tag":"Test Clock","count":5},{"language":"cn","tag":"接入","count":5},{"language":"cn","tag":"概述","count":5},{"language":"cn","tag":"Payment Methods","count":5},{"language":"cn","tag":"Account","count":5},{"language":"default","tag":"Subscription","count":3},{"language":"default","tag":"Checkout Session","count":3},{"language":"default","tag":"Agent Payment Session","count":2},{"language":"default","tag":"Price","count":2},{"language":"default","tag":"Product","count":2},{"language":"default","tag":"Order","count":1}]},"assistantConfig":{},"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":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/agent-portal/bind_card","slug":"/api-reference/agent-portal/bind_card","pageMetadata":{"title":"Bind a card","openapi":"POST /agent/platform/bind-sessions","description":"Creates a short-lived card-binding session for the token's customer and returns a URL that the user opens to add a card. Requires `portal:write`.","href":"/api-reference/agent-portal/bind_card"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Creates a short-lived card-binding session for the token’s customer and returns a URL that the user opens to add a card. Requires \", _jsx(_components.code, {\n children: \"portal:write\"\n }), \".\"]\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`,..._provideComponents(),...props.components},{Warning}=_components;if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`This endpoint does not create an instruction and does not authorize spending. Use it when the user only needs to add a card. To bind a card and sign in one flow, omit `,_jsx(_components.code,{children:`payment_instrument_id`}),` in `,_jsx(_components.a,{href:`/api-reference/agent-portal/create_instruction`,children:`Create instruction`}),` instead. There are no body fields for choosing a customer; the session is always created for the token’s customer.`]}),`\n`,_jsxs(_components.p,{children:[`Each call creates a new, independent session with a short TTL. When the user opens the link and completes the card-binding ceremony, the card is added to the customer’s payment methods (`,_jsx(_components.a,{href:`/api-reference/agent-portal/list_payment_methods`,children:`List payment methods`}),`). No instruction or authorization is created. The link can be reopened or re-exchanged while the session is still pending; it stops working once the card-binding ceremony completes or the session expires.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Treat the card-binding link as a credential. Do not forward it, screenshot it, or write it to logs; anyone who has the link can open it while it is valid and complete card binding for that customer. Deliver it only to the intended user.`})})]})}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":"Bind a card","openapi":"POST /agent/platform/bind-sessions","description":"Creates a short-lived card-binding session for the token's customer and returns a URL that the user opens to add a card. Requires `portal:write`.","href":"/api-reference/agent-portal/bind_card"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Bind a card","description":"Creates a short-lived card-binding session for the token's customer and returns a URL that the user opens to add a card. Requires `portal:write`.","operationId":"createBindSession","responses":{"200":"b6e13bcc-3fa6-4f40-b15e-8e6231b0f3a8","401":"279665ad-ed61-421c-b961-3096e056aea4","403":"fdd6e5cc-1c3a-417f-a15f-667714c73877","429":"4e14a0b2-7dd0-431d-a0f2-f6d45184c9e2"},"method":"post","type":"path","servers":["5ea4f0ea-3214-4d21-a455-d285f3de637f"],"security":["d4c33e13-aa8b-402b-a4ee-08669f9a2053"],"path":"/agent/platform/bind-sessions","baseUrlOptions":["https://uat-api.clinkbill.com"],"title":"Bind a card","codeSamples":[],"requestExampleLanguages":["bash","java","python","javascript"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"responses":{"b6e13bcc-3fa6-4f40-b15e-8e6231b0f3a8":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","format":"int32","description":"`200` on success.","example":200,"uniqueKey":"code","typeLabel":"integer\u003cint32>"},"msg":{"type":"string","description":"Result message.","example":"Success","uniqueKey":"msg","typeLabel":"string"},"data":{"type":"object","properties":{"session_id":{"type":"string","description":"Opaque short-lived card-binding session ID.","example":"vs_...","uniqueKey":"data.session_id","typeLabel":"string"},"url":{"type":"string","description":"Short-lived card-binding link the user opens in a browser. It contains the session ID and does not contain a portal token.","example":"https://agent.clinkbill.dev/vault/vs_...","uniqueKey":"data.url","typeLabel":"string"},"expires_at":{"type":"string","description":"Time after which the link no longer works.","format":"date-time","example":"2026-11-09T10:30:00Z","uniqueKey":"data.expires_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":200,"msg":"Success","data":{"session_id":"vs_...","url":"https://agent.clinkbill.dev/vault/vs_...","expires_at":"2026-11-09T10:30:00Z"}},"examples":{"Example":{"title":"Example","value":{"code":200,"msg":"Success","data":{"session_id":"vs_...","url":"https://agent.clinkbill.dev/vault/vs_...","expires_at":"2026-11-09T10:30:00Z"}}}},"exampleType":"examples"}},"exampleType":"examples"},"279665ad-ed61-421c-b961-3096e056aea4":{"description":"Missing, expired, or invalid portal token.","content":{"application/json":{"schema":{"type":"object","description":"Business errors use the standard envelope without `data`.","properties":{"code":{"type":"integer","description":"Numeric business error code. Judge an error by the HTTP status together with `code`, not by a string error code.","uniqueKey":"code","typeLabel":"integer"},"msg":{"type":"string","description":"Human-readable description.","uniqueKey":"msg","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":123,"msg":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"fdd6e5cc-1c3a-417f-a15f-667714c73877":{"description":"Wrong token audience, missing `portal:write` scope, or a platform client token used instead of a portal token.","content":{"application/json":{"schema":{"type":"object","description":"Business errors use the standard envelope without `data`.","properties":{"code":{"type":"integer","description":"Numeric business error code. Judge an error by the HTTP status together with `code`, not by a string error code.","uniqueKey":"code","typeLabel":"integer"},"msg":{"type":"string","description":"Human-readable description.","uniqueKey":"msg","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":123,"msg":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"4e14a0b2-7dd0-431d-a0f2-f6d45184c9e2":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"type":"object","description":"Business errors use the standard envelope without `data`.","properties":{"code":{"type":"integer","description":"Numeric business error code. Judge an error by the HTTP status together with `code`, not by a string error code.","uniqueKey":"code","typeLabel":"integer"},"msg":{"type":"string","description":"Human-readable description.","uniqueKey":"msg","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":123,"msg":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"d4c33e13-aa8b-402b-a4ee-08669f9a2053":{"PortalToken":{"type":"http","scheme":"bearer","description":"Portal user token from `POST /agent/cwallet/platform/portal/tokens`. Reads require `portal:read`; writes require `portal:write`.","scopes":[],"schemeName":"PortalToken"}}},"servers":{"5ea4f0ea-3214-4d21-a455-d285f3de637f":{"url":"https://uat-api.clinkbill.com","description":"Sandbox"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Portal user token from `POST /agent/cwallet/platform/portal/tokens`. Reads require `portal:read`; writes require `portal:write`.","scopes":[],"schemeName":"PortalToken"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Portal user token from `POST /agent/cwallet/platform/portal/tokens`. Reads require `portal:read`; writes require `portal:write`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"PortalToken","name":"Authorization"}],"title":"PortalToken"}]},"originalFileLocation":"api-reference/agent-portal/openapi.json"},"subdomain":"clink","siteName":"Clink Documentation","title":"Bind a card - Clink Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/agent-portal/bind_card","matchLevel":0},"cn":{"href":"/cn/api-reference/agent-portal/bind_card","matchLevel":1}}},"lastModified":"2026-11-17T16:54:14.012Z","originalFileLocation":"api-reference/agent-portal/bind_card.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Creates a short-lived card-binding session for the token\u0026#x27;s customer and returns a URL that the user opens to add a card. Requires portal:write.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Clink Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/clink/ur0VwNJVZSsj7vK4/_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/clink/ur0VwNJVZSsj7vK4/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/clink/ur0VwNJVZSsj7vK4/_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/clink/ur0VwNJVZSsj7vK4/_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/clink/ur0VwNJVZSsj7vK4/_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/clink/ur0VwNJVZSsj7vK4/_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/clink/ur0VwNJVZSsj7vK4/_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/clink/ur0VwNJVZSsj7vK4/_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/clink/ur0VwNJVZSsj7vK4/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Bind a card - Clink Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a short-lived card-binding session for the token\u0026#x27;s customer and returns a URL that the user opens to add a card. Requires portal:write.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Clink Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.clinkbill.com/api-reference/agent-portal/bind_card\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://clink.mintlify.site/_mintlify/api/og/v2?division=Payment+Methods\u0026amp;title=Bind+a+card\u0026amp;description=Creates+a+short-lived+card-binding+session+for+the+token%27s+customer+and+returns+a+URL+that+the+user+opens+to+add+a+card.+Requires+%60portal%3Awrite%60.\u0026amp;theme=be5a6376d6c12292dd7b4d25\u0026amp;signature=45db3c4f627e323a4990650178d32c5c29ec06d2dd1af896b3283d969ebb4155\">\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=\"Bind a card - Clink Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a short-lived card-binding session for the token\u0026#x27;s customer and returns a URL that the user opens to add a card. Requires portal:write.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://clink.mintlify.site/_mintlify/api/og/v2?division=Payment+Methods\u0026amp;title=Bind+a+card\u0026amp;description=Creates+a+short-lived+card-binding+session+for+the+token%27s+customer+and+returns+a+URL+that+the+user+opens+to+add+a+card.+Requires+%60portal%3Awrite%60.\u0026amp;theme=be5a6376d6c12292dd7b4d25\u0026amp;signature=45db3c4f627e323a4990650178d32c5c29ec06d2dd1af896b3283d969ebb4155\">\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/clink/ur0VwNJVZSsj7vK4/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Clink Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FF9472\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.clinkbill.com/api-reference/agent-portal/bind_card\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/agent-portal/bind_card.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.clinkbill.com/api-reference/agent-portal/bind_card\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.clinkbill.com/cn/api-reference/agent-portal/bind_card\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.clinkbill.com/api-reference/agent-portal/bind_card\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.clinkbill.com/#organization\",\"name\":\"Clink Documentation\",\"url\":\"https://docs.clinkbill.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/clink/SmNnnZK50PsVdBCU/logo/light_new.svg?fit=max\u0026auto=format\u0026n=SmNnnZK50PsVdBCU\u0026q=85\u0026s=9956e279765b6e968dcc19748a3ee896\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.clinkbill.com#website\",\"name\":\"Clink Documentation\",\"url\":\"https://docs.clinkbill.com\",\"publisher\":{\"@id\":\"https://docs.clinkbill.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.clinkbill.com/api-reference/agent-portal/bind_card#webpage\",\"url\":\"https://docs.clinkbill.com/api-reference/agent-portal/bind_card\",\"name\":\"Bind a card\",\"description\":\"Creates a short-lived card-binding session for the token's customer and returns a URL that the user opens to add a card. Requires portal:write.\",\"dateModified\":\"2026-11-17T16:54:14.012Z\",\"isPartOf\":{\"@id\":\"https://docs.clinkbill.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.clinkbill.com/api-reference/agent-portal/bind_card#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.clinkbill.com/api-reference/agent-portal/bind_card#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Agent Portal\",\"item\":\"https://docs.clinkbill.com/api-reference/agent-portal/portal_token\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Payment Methods\",\"item\":\"https://docs.clinkbill.com/api-reference/agent-portal/list_payment_methods\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Bind a card\",\"item\":\"https://docs.clinkbill.com/api-reference/agent-portal/bind_card\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.clinkbill.com/api-reference/agent-portal/bind_card#apireference\",\"headline\":\"Bind a card\",\"name\":\"Bind a card\",\"description\":\"Creates a short-lived card-binding session for the token's customer and returns a URL that the user opens to add a card. Requires portal:write.\",\"url\":\"https://docs.clinkbill.com/api-reference/agent-portal/bind_card\",\"mainEntityOfPage\":{\"@id\":\"https://docs.clinkbill.com/api-reference/agent-portal/bind_card#webpage\"},\"dateModified\":\"2026-11-17T16:54:14.012Z\",\"publisher\":{\"@id\":\"https://docs.clinkbill.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.clinkbill.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Clink Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Clink Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/agent-portal/bind_card.md","siteName":"Clink Documentation","nav":{"global":null,"languages":[{"language":"en","tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","groups":[{"group":"API Documentation","pages":[{"title":"Introduction","icon":"chevrons-left-right-ellipsis","href":"/api-reference/introduction"},{"title":"TypeScript SDK","icon":"npm","href":"/api-reference/SDK"},{"title":"JavaScript SDK","icon":"code","href":"/api-reference/javascript_sdk"},{"title":"Clink CLI","icon":"terminal","href":"/api-reference/clink_cli"},{"title":"Agent Vault SDK API reference","sidebarTitle":"Agent Vault SDK","icon":"vault","href":"/api-reference/agent_vault_sdk"}]},{"group":"Clink MCP","pages":[{"title":"Wallet MCP tools","icon":"wallet","href":"/api-reference/mcp/wallet"},{"title":"Browser Pay tools","icon":"app-window","href":"/api-reference/mcp/browser_pay"},{"title":"Operations and recovery","icon":"refresh-cw","href":"/api-reference/mcp/operations"},{"title":"Catalog and UCP Checkout","icon":"shopping-cart","href":"/api-reference/mcp/commerce"},{"title":"Agent Platform MCP Login","icon":"key-round","href":"/api-reference/mcp/agent_platform_login"}]},{"group":"Agent Portal","icon":"layout-dashboard","pages":[{"title":"Portal token","openapi":"POST /agent/cwallet/platform/portal/tokens","href":"/api-reference/agent-portal/portal_token"},{"group":"Account","pages":[{"title":"Get account","openapi":"GET /agent/platform/me","href":"/api-reference/agent-portal/get_account"},{"title":"Get risk rules","openapi":"GET /agent/platform/risk-rules","href":"/api-reference/agent-portal/get_risk_rules"},{"title":"Update risk rules","openapi":"PUT /agent/platform/risk-rules","href":"/api-reference/agent-portal/update_risk_rules"},{"title":"Get billing address","openapi":"GET /agent/platform/billing-address","href":"/api-reference/agent-portal/get_billing_address"},{"title":"Update billing address","openapi":"PUT /agent/platform/billing-address","href":"/api-reference/agent-portal/update_billing_address"}]},{"group":"Payment Methods","pages":[{"title":"List payment methods","openapi":"GET /agent/platform/payment-methods","description":"Lists the payment methods of the token's customer.","href":"/api-reference/agent-portal/list_payment_methods"},{"title":"Bind a card","openapi":"POST /agent/platform/bind-sessions","href":"/api-reference/agent-portal/bind_card"},{"title":"Create a Vault session","openapi":"POST /agent/platform/vault-sessions","description":"Creates a short-lived Vault (hosted card-binding) session for the token's customer and returns its `vault_id`, the hosted page `url`, and the expiry. Requires `portal:write`.","href":"/api-reference/agent-portal/create_vault_session"},{"title":"Create a card session","openapi":"POST /agent/platform/card-sessions","href":"/api-reference/agent-portal/create_card_session"},{"title":"Delete payment method","openapi":"DELETE /agent/platform/payment-methods/{paymentInstrumentId}","href":"/api-reference/agent-portal/delete_payment_method"}]},{"group":"Orders","pages":[{"title":"List orders","openapi":"GET /agent/platform/orders","href":"/api-reference/agent-portal/list_orders"},{"title":"Get order","openapi":"GET /agent/platform/orders/{orderId}","href":"/api-reference/agent-portal/get_order"}]},{"group":"Refunds","pages":[{"title":"List refunds","openapi":"GET /agent/platform/refunds","href":"/api-reference/agent-portal/list_refunds"},{"title":"Get refund","openapi":"GET /agent/platform/refunds/{refundOrderId}","href":"/api-reference/agent-portal/get_refund"}]},{"group":"Authorizations","pages":[{"title":"List authorizations","openapi":"GET /agent/platform/authorizations","href":"/api-reference/agent-portal/list_authorizations"},{"title":"Get authorization","openapi":"GET /agent/platform/authorizations/{instructionId}","href":"/api-reference/agent-portal/get_authorization"},{"title":"Create instruction","openapi":"POST /agent/platform/authorizations","href":"/api-reference/agent-portal/create_instruction"}]},{"group":"Credentials","pages":[{"title":"Get credential","openapi":"POST /agent/platform/credential","href":"/api-reference/agent-portal/get_credential"},{"title":"Report credential result","openapi":"POST /agent/platform/credential-results","href":"/api-reference/agent-portal/report_credential_result"}]}]},{"group":"Checkout Session","pages":[{"title":"Create Checkout Session","openapi":"POST /checkout/session","href":"/api-reference/endpoint/create-checkout-session"},{"title":"Get Checkout Session","openapi":"GET /checkout/session/{id}","href":"/api-reference/endpoint/get-checkout-session"},{"title":"Expire Checkout Session","openapi":"POST /checkout/session/{id}/expire","href":"/api-reference/endpoint/expire-checkout-session"}]},{"group":"Payment","pages":[{"title":"Create Payment","openapi":"POST /payment","href":"/api-reference/endpoint/create-payment"},{"title":"Refresh Wallet QR Code","openapi":"POST /payment/{orderId}/qrcode/refresh","href":"/api-reference/endpoint/refresh-wallet-qrcode"}]},{"group":"Payment Instrument","pages":[{"title":"Create Payment Instrument","openapi":"POST /payment-instrument","href":"/api-reference/endpoint/create-payment-instrument"}]},{"group":"Order","pages":[{"title":"List Orders","openapi":"GET /order","href":"/api-reference/endpoint/list-orders"},{"title":"Get Order","openapi":"GET /order/{id}","href":"/api-reference/endpoint/get-order"}]},{"group":"Agent Payment Session","pages":[{"title":"Create Agent Payment Session","openapi":"POST /order/payment-session","href":"/api-reference/endpoint/create-agent-payment-session"},{"title":"Get Agent Payment Session","openapi":"GET /order/payment-session/{sessionId}","href":"/api-reference/endpoint/get-agent-payment-session"}]},{"group":"Refund","pages":[{"title":"Create Refund","openapi":"POST /refund","href":"/api-reference/endpoint/create-refund"},{"title":"Get Refund","openapi":"GET /refund/{id}","href":"/api-reference/endpoint/get-refund"}]},{"group":"Product","pages":[{"title":"Upload Product Image","openapi":"POST /product/image/upload","href":"/api-reference/endpoint/upload-product-image"},{"title":"Create Product","openapi":"POST /product","href":"/api-reference/endpoint/create-product"},{"title":"Get Product","openapi":"GET /product/{id}","href":"/api-reference/endpoint/get-product"},{"title":"Get Product List","openapi":"GET /product","href":"/api-reference/endpoint/get-product-list"}]},{"group":"Price","pages":[{"title":"Create Price","openapi":"POST /price","href":"/api-reference/endpoint/create-price"},{"title":"Get Price","openapi":"GET /price/{id}","href":"/api-reference/endpoint/get-price"},{"title":"Get Price List","openapi":"GET /price","href":"/api-reference/endpoint/get-price-list"},{"title":"Update Price","openapi":"PUT /price/{id}","href":"/api-reference/endpoint/update-price"}]},{"group":"Coupon","pages":[{"title":"Create Coupon","openapi":"POST /coupon","href":"/api-reference/endpoint/create-coupon"},{"title":"List Coupons","openapi":"GET /coupon","href":"/api-reference/endpoint/list-coupons"},{"title":"Get Coupon","openapi":"GET /coupon/{couponId}","href":"/api-reference/endpoint/get-coupon"},{"title":"Rename Coupon","openapi":"PUT /coupon/{couponId}/name","href":"/api-reference/endpoint/rename-coupon"}]},{"group":"Promotion Code","pages":[{"title":"Create Promotion Code","openapi":"POST /promotion-code/{id}","href":"/api-reference/endpoint/create-promotion-code"},{"title":"Get Promotion Code","openapi":"GET /promotion-code/{id}","href":"/api-reference/endpoint/get-promotion-code"},{"title":"List Promotion Codes by Coupon","openapi":"GET /promotion-code/coupon/{couponId}","href":"/api-reference/endpoint/list-promotion-codes-by-coupon"},{"title":"Activate Promotion Code","openapi":"PUT /promotion-code/{promotionCodeId}/active","href":"/api-reference/endpoint/activate-promotion-code"},{"title":"Deactivate Promotion Code","openapi":"PUT /promotion-code/{promotionCodeId}/deactivate","href":"/api-reference/endpoint/deactivate-promotion-code"}]},{"group":"Subscription","pages":[{"title":"Create Subscription","openapi":"POST /subscription","href":"/api-reference/endpoint/create-subscription"},{"title":"Get Subscription","openapi":"GET /subscription/{id}","href":"/api-reference/endpoint/get-subscription"},{"title":"Preview Subscription Update","openapi":"POST /subscription/{id}/update/preview","href":"/api-reference/endpoint/preview-subscription-update"},{"title":"Confirm Subscription Update","openapi":"POST /subscription/{id}/update/confirm","href":"/api-reference/endpoint/confirm-subscription-update"},{"title":"Cancel Subscription Update","openapi":"POST /subscription/{id}/update/cancel","href":"/api-reference/endpoint/cancel-subscription-update"},{"title":"Cancel Subscription","openapi":"POST /subscription/{id}/cancel","href":"/api-reference/endpoint/cancel-subscription"},{"title":"Get Invoice","openapi":"GET /subscription/invoice/{id}","href":"/api-reference/endpoint/get-invoice"}]},{"group":"Test Clock","pages":[{"title":"List Test Clocks","openapi":"GET /subscription/test-clocks/list","href":"/api-reference/endpoint/list-test-clocks"},{"title":"Create Test Clock","openapi":"POST /subscription/test-clocks","href":"/api-reference/endpoint/create-test-clock"},{"title":"Get Test Clock","openapi":"GET /subscription/test-clocks/{clockId}","href":"/api-reference/endpoint/get-test-clock"},{"title":"Advance Test Clock","openapi":"POST /subscription/test-clocks/{clockId}/advance","href":"/api-reference/endpoint/advance-test-clock"},{"title":"Complete Test Clock","openapi":"POST /subscription/test-clocks/{clockId}/complete","href":"/api-reference/endpoint/complete-test-clock"}]},{"group":"Customer Portal","pages":[{"title":"Customer Portal Session","openapi":"POST /billing/session","href":"/api-reference/endpoint/create-customer-portal"}]},{"group":"Webhook Endpoint Management","pages":[{"title":"List Webhook Events","openapi":"GET /webhook/events","href":"/api-reference/endpoint/list-webhook-events"},{"title":"List Webhook Endpoints","openapi":"GET /webhook/endpoints","href":"/api-reference/endpoint/list-webhook-endpoints"},{"title":"Create Webhook Endpoint","openapi":"POST /webhook/endpoints","href":"/api-reference/endpoint/create-webhook-endpoint"},{"title":"Ensure Webhook Endpoint","openapi":"PUT /webhook/endpoints/ensure","href":"/api-reference/endpoint/ensure-webhook-endpoint"},{"title":"Get Webhook Endpoint","openapi":"GET /webhook/endpoints/{id}","href":"/api-reference/endpoint/get-webhook-endpoint"},{"title":"Update Webhook Endpoint","openapi":"PATCH /webhook/endpoints/{id}","href":"/api-reference/endpoint/update-webhook-endpoint"},{"title":"Enable Webhook Endpoint","openapi":"POST /webhook/endpoints/{id}/enable","href":"/api-reference/endpoint/enable-webhook-endpoint"},{"title":"Disable Webhook Endpoint","openapi":"POST /webhook/endpoints/{id}/disable","href":"/api-reference/endpoint/disable-webhook-endpoint"},{"title":"Rotate Webhook Signing Secret","openapi":"POST /webhook/endpoints/{id}/rotate-secret","href":"/api-reference/endpoint/rotate-webhook-signing-secret"},{"title":"Delete Webhook Endpoint","openapi":"DELETE /webhook/endpoints/{id}","href":"/api-reference/endpoint/delete-webhook-endpoint"}]},{"group":"Webhooks","pages":[{"title":"order","openapi":"WEBHOOK order","href":"/api-reference/webhook/order"},{"title":"refund","openapi":"WEBHOOK refund","href":"/api-reference/webhook/refund"},{"title":"subscription","openapi":"WEBHOOK subscription","href":"/api-reference/webhook/subscription"},{"title":"invoice","openapi":"WEBHOOK invoice","href":"/api-reference/webhook/invoice"},{"title":"session","openapi":"WEBHOOK session","href":"/api-reference/webhook/session"},{"title":"customer.verify","openapi":"WEBHOOK customer.verify","href":"/api-reference/webhook/customer.verify"},{"title":"dispute","openapi":"WEBHOOK dispute","href":"/api-reference/webhook/dispute"}]}]}]},{"language":"cn","pages":[{"title":"cn","href":"/cn/api-reference/agent-portal/bind_card"}]}]},"basePath":"","title":"Bind a card - Clink Documentation","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-jJHA3WSo.js","utils-DbZn3Mjn.js","cloneDeep-CnBnaSyy.js","_Uint8Array-CMQtTgBR.js","isObject-FP1Yky1u.js","utils-Bl2DvzOJ.js","addUniqueKeysToSchema-BwOLo9p1.js","snippetPresets-BBiPpKa-.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-C0px4Tml.js","isEqual-zAyttAAO.js","usePlaygroundInputsStore-Dell6dGw.js","shallow-0VKqkSqN.js","getApiPlaygroundDisplay-CP_ctPEB.js","CodeSnippet-5L35ic0s.js","CodeSnippets-DOXbNhJw.js","Page-DRLI_2Ue.js","getPastedJson-VhzT9m2P.js","icon-CD8_AtCO.js","MethodPill-DGgOMftG.js","DuplicateIcon-DZ6A_EtN.js","createIcon-DUl4oM5f.js","DynamicMarkdown-BGHukeRM.js","SectionHeading-ChrEUs8u.js","axios-vUo_bRtp.js","Markdown-Dj-na-_-.js","dist-C5gjFYHe.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-DEBW87tT.js"]}