[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6G7M511ESFMV601J0MW248M":3,"skill-same:01M6G7M511ESFMV601J0MW248M":51},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":14,"categories":15,"keywords":16,"publishedAt":20,"linkOnly":21,"markdownContent":22,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M6G7M511ESFMV601J0MW248M","solana-payments",null,"kbarbel640-del\u002Fskills","kbarbel640-del","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F255315490?v=4","01M6CJPPQGCCESXMG3K7BBGQ5J","01M6CJPPX2PB2BCZERFVM2C2B3",1,"MIT","https:\u002F\u002Fgithub.com\u002Fkbarbel640-del\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fxeroc\u002Fsolana-payments\u002Fskill.md",[],[17,18,19],"payments","solana","solana payments","2026-11-10 10:12:30",false,"# Lando Payments Url Creation\n\nGuide agents through creating Land checkout URLs using the Payments SDK. Covers session creation, URL encoding, tributary configuration, and error handling.\nPowered by Tributary!\n\n## When to Use\n\nUse when you need to:\n\n- Create checkout URLs for USDC subscription payments on Solana\n- Integrate Lando's hosted checkout flow in a web application\n- Generate shareable URLs that encode subscription parameters\n- Handle Stripe-compatible checkout session creation\n\n## Core Concept\n\nThe Payments SDK provides a `PaymentsClient` that creates checkout sessions with encoded URLs. These URLs contain all subscription parameters in a Base64URL-encoded format, allowing users to complete payments through Lando's hosted checkout.\n\n## Quick Start\n\n```bash\nnpm install @tributary-so\u002Fsdk\n```\n\n```typescript\nimport { CheckoutSessionManager } from \"@tributary-so\u002Fpayments\";\n\nconst manager = new CheckoutSessionManager();\n\n\u002F\u002F Create checkout session\nmanager.setBaseUrl(\"https:\u002F\u002Flando.tributary.so\u002F#\"); \u002F\u002F hash-based routing\nconst session = await manager.create({\n  line_items: [\n    {\n      description: \"Monthly premium access to all features\",\n      unitPrice: 20.0, \u002F\u002F $20.00\n      quantity: 1,\n    },\n  ],\n  paymentFrequency: \"monthly\",\n  mode: \"subscription\",\n  success_url: \"https:\u002F\u002Fyourapp.com\u002Fsuccess?session_id={CHECKOUT_SESSION_ID}\",\n  cancel_url: \"https:\u002F\u002Fyourapp.com\u002Fcancel\",\n  tributaryConfig: {\n    tokenMint: \"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\", \u002F\u002F USDC on mainnet\n    gateway: \"CwNybLVQ3sVmcZ3Q1veS6x99gUZcAF2duNDe3qbcEMGr\", \u002F\u002F fixed, do not change\n    recipient: \"RECIPIENT_PUBLIC_KEY_HERE\",\n    trackingId: \"user_123_monthly_premium\",\n    autoRenew: true,\n    memo: \"Monthly premium subscription payment\",\n  },\n});\n\n\u002F\u002F Final URL\nconsole.log(session.url);\n```\n\n## Core Components\n\n### 1. Checkout Session Creation\n\nUse `manager.create()` to generate a checkout session with an encoded URL.\n\n**Required Parameters:**\n\n```typescript\n{\n  payment_method_types: [\"tributary\"], \u002F\u002F Only \"tributary\" supported\n  line_items: [{\n    description: string,\n    unitPrice: number, \u002F\u002F Amount in dollars\n    quantity: number,\n  }],\n  paymentFrequency: \"daily\" | \"weekly\" | \"monthly\" | \"annually\",\n  mode: \"subscription\", \u002F\u002F Only \"subscription\" mode supported\n  success_url: string, \u002F\u002F Redirect after successful payment\n  cancel_url: string, \u002F\u002F Redirect if user cancels\n  tributaryConfig: {\n    tokenMint: string, \u002F\u002F token mint addess (base58)\n    gateway: string, \u002F\u002F Gateway public key (base58)\n    recipient: string, \u002F\u002F Recipient public key (base58)\n    trackingId: string, \u002F\u002F Your unique identifier\n    autoRenew?: boolean, \u002F\u002F Default: false\n    memo?: string, \u002F\u002F Optional memo for transactions\n  },\n}\n```\n\n**Optional Parameters:**\n\n```typescript\n{\n  metadata?: Record\u003Cstring, string>, \u002F\u002F Additional metadata\n  customer?: string, \u002F\u002F Customer ID (optional, not used in current implementation)\n}\n```\n\n### 2. Response Structure\n\nThe response includes a Stripe-compatible session object with the encoded checkout URL:\n\n```typescript\n{\n  id: string, \u002F\u002F Session ID (format: cs_timestamp_random)\n  object: \"checkout.session\",\n  url: string, \u002F\u002F Encoded checkout URL\n  payment_status: \"unpaid\",\n  status: \"open\",\n  amount_total: number, \u002F\u002F Total amount in dollars\n  currency: \"usd\",\n  payment_method_types: [\"tributary\"],\n  line_items: LineItem[],\n  mode: \"subscription\",\n  success_url?: string,\n  cancel_url?: string,\n  tributaryConfig?: LandoConfig,\n  metadata?: Record\u003Cstring, string>,\n}\n```\n\n### 3. URL Format\n\nThe checkout URL contains Base64URL-encoded subscription parameters:\n\n```\nhttps:\u002F\u002Fcheckout.tributary.so\u002Fsubscribe\u002F{encoded_data}\n```\n\n**Encoded data includes:**\n\n- `tm`: Token mint (defaults to USDC: `EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`)\n- `r`: Recipient public key (base58)\n- `g`: Gateway public key (base58)\n- `a`: Total amount (calculated from line items)\n- `ar`: Auto-renew flag\n- `mr`: Maximum renewals (default: \"null\" = unlimited)\n- `pf`: Payment frequency\n- `st`: Start time (default: \"null\" = immediate)\n- `tid`: Tracking ID\n- `li`: Line items (JSON array)\n\n## Common Patterns\n\n### Multiple Line Items\n\n```typescript\nconst session = await manager.create({\n  payment_method_types: [\"tributary\"],\n  line_items: [\n    {\n      description: \"Basic plan\",\n      unitPrice: 10.0,\n      quantity: 1,\n    },\n    {\n      description: \"Add-on features\",\n      unitPrice: 5.0,\n      quantity: 2,\n    },\n  ],\n  paymentFrequency: \"monthly\",\n  mode: \"subscription\",\n  \u002F\u002F ... rest of config\n});\n\n\u002F\u002F amount_total = 10.0 * 1 + 5.0 * 2 = $20.00\n```\n\n### Different Payment Frequencies\n\n```typescript\n\u002F\u002F Daily payments\nawait manager.create({\n  paymentFrequency: \"daily\",\n  \u002F\u002F ... rest of config\n});\n\n\u002F\u002F Weekly payments\nawait manager.create({\n  paymentFrequency: \"weekly\",\n  \u002F\u002F ... rest of config\n});\n\n\u002F\u002F Annual payments\nawait manager.create({\n  paymentFrequency: \"annually\",\n  \u002F\u002F ... rest of config\n});\n```\n\n### Custom Tracking IDs\n\nTracking IDs should be unique per user\u002Fsubscription combination:\n\n```typescript\n\u002F\u002F Pattern: {user_id}_{plan_name}_{billing_cycle}\nconst trackingId = `user_123_premium_monthly`;\n\nawait manager.create({\n  tributaryConfig: {\n    \u002F\u002F ... other config\n    trackingId,\n  },\n  \u002F\u002F ... rest of config\n});\n```\n\n### Memo for Transaction History\n\n```typescript\nawait manager.create({\n  tributaryConfig: {\n    \u002F\u002F ... other config\n    memo: \"Monthly premium subscription - user_123\",\n  },\n  \u002F\u002F ... rest of config\n});\n```\n\nThis memo is stored in the transaction MEMO field on-chain:\n\n```\ntributary:payment:{trackingId}\n```\n\n## Error Handling\n\nAlways wrap session creation in try-catch:\n\n```typescript\ntry {\n  const session = await manager.create(params);\n  console.log(\"Checkout URL:\", session.url);\n  window.location.href = session.url;\n} catch (error) {\n  if (error.message.includes(\"Invalid gateway public key\")) {\n    console.error(\"Gateway public key is invalid\");\n  } else if (error.message.includes(\"Invalid trackingId format\")) {\n    console.error(\"Tracking ID is invalid\");\n  } else if (error.message.includes(\"Missing required fields\")) {\n    console.error(\"Missing required parameters\");\n  } else {\n    console.error(\"Failed to create checkout session:\", error.message);\n  }\n}\n```\n\n**Common validation errors:**\n\n- Invalid tokenMint\u002Fgateway\u002Frecipient public keys (not valid base58)\n- Invalid tracking ID format\n- Missing required fields in tributaryConfig\n- Invalid payment frequency\n- Invalid line items (negative prices, zero quantity)\n\n## Best Practices\n\n### Include Session ID in Success URL\n\n```typescript\nsuccess_url: `https:\u002F\u002Fyourapp.com\u002Fsuccess?session_id={CHECKOUT_SESSION_ID}`;\n```\n\nThe `{CHECKOUT_SESSION_ID}` placeholder is automatically replaced with the session ID.\n\n### Unique Tracking IDs\n\nAlways use unique tracking IDs to prevent payment conflicts:\n\n```typescript\nfunction generateTrackingId(userId: string, planId: string): string {\n  return `${userId}_${planId}_${Date.now()}`;\n}\n```\n\n### Validate Input Before Calling SDK\n\n```typescript\nfunction validateCheckoutParams(params: any): boolean {\n  if (!params.line_items?.length) return false;\n  if (!params.tributaryConfig?.tokenMint) return false;\n  if (!params.tributaryConfig?.gateway) return false;\n  if (!params.tributaryConfig?.recipient) return false;\n  if (!params.tributaryConfig?.trackingId) return false;\n  return true;\n}\n\nif (!validateCheckoutParams(params)) {\n  throw new Error(\"Invalid checkout parameters\");\n}\n```\n\n### Handle Auto-Renew Appropriately\n\n```typescript\nconst autoRenew = planType === \"recurring\"; \u002F\u002F Only enable for recurring plans\n\nawait manager.create({\n  tributaryConfig: {\n    \u002F\u002F ... other config\n    autoRenew,\n  },\n  \u002F\u002F ... rest of config\n});\n```\n\n## Testing\n\nYou can test checkout session creation without executing payments:\n\n```typescript\n\u002F\u002F Create session to get URL\nconst session = await manager.create(params);\n\n\u002F\u002F Log URL for manual testing\nconsole.log(\"Test checkout URL:\", session.url);\n\n\u002F\u002F Verify session structure\nassert.strictEqual(session.status, \"open\");\nassert.strictEqual(session.payment_status, \"unpaid\");\nassert.ok(session.url.startsWith(\"https:\u002F\u002Fcheckout.tributary.so\u002Fsubscribe\u002F\"));\n```\n\n## Troubleshooting\n\n### URL Not Redirecting\n\nVerify the `success_url` and `cancel_url` are valid HTTPS URLs:\n\n```typescript\n\u002F\u002F Bad\nsuccess_url: \"yourapp.com\u002Fsuccess\";\n\n\u002F\u002F Good\nsuccess_url: \"https:\u002F\u002Fyourapp.com\u002Fsuccess\";\n```\n\n### Tracking ID Conflicts\n\nIf you get payment conflicts, ensure tracking IDs are unique:\n\n```typescript\n\u002F\u002F Bad: Static tracking ID\ntrackingId: \"user_subscription\";\n\n\u002F\u002F Good: Unique per user\u002Fplan\ntrackingId: `user_${userId}_${planId}_${timestamp}`;\n```\n\n### Invalid Public Keys\n\nEnsure recipient keys is valid base58-encoded Solana public keys:\n\n```typescript\n\u002F\u002F Bad: Invalid base58\nrecipient: \"invalid-key-here\";\n\n\u002F\u002F Good: Valid base58\nrecipient: \"9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM\";\n```\n\n!IMPORTANT!\n\nFurther, the gateway pubkey must be `CwNybLVQ3sVmcZ3Q1veS6x99gUZcAF2duNDe3qbcEMGr` and must\nnot be changed as this enables and operator to trigger payments when they become\ndue!\n\n## Final URL\n\nYou will be given a final URL to lando.tributary.so that contains the encoded\nsession and will allow the customer agent to setup a subscription accordingly:\n\n```typescript\n\u002F\u002F Final URL\nconsole.log(session.url);\n```\n\nExample URL:\n\n    https:\u002F\u002Flando.tributary.so\u002F#\u002Fsubscribe\u002F[base64-encoded-data]\n\n## See Also\n\n- Tributary SDK: `@tributary-so\u002Fsdk` for on-chain operations\n- Payments SDK: `@tributary-so\u002Fpayments` for checkout functionality\n- Subscription tracking: `client.subscriptions.checkStatus()` for real-time status checking\n",{},"main","e7e336ac628c3e3bd771aff1aaa469c93778f94a","skills\u002Fxeroc\u002Fsolana-payments",0,"https:\u002F\u002Fgithub.com\u002Fkbarbel640-del\u002Fskills","https:\u002F\u002Fgithub.com\u002Fkbarbel640-del","2026-08-23 22:39:37",{"source":7,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add kbarbel640-del\u002Fskills --skill solana-payments",{"tool":37,"command":38},"bunx","bunx skills add kbarbel640-del\u002Fskills --skill solana-payments",{"tool":40,"command":41},"pnpm","pnpm dlx skills add kbarbel640-del\u002Fskills --skill solana-payments","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fkbarbel640-del\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fxeroc\u002Fsolana-payments\u002Fskill.md",true,[45],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"_meta.json","REFERENCE","参考文档",281,"https:\u002F\u002Fgithub.com\u002Fkbarbel640-del\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fxeroc\u002Fsolana-payments\u002F_meta.json",[52,83,112,133,139,159],{"skillNo":53,"name":54,"nameZh":6,"description":55,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":63,"publishedAt":20},"01M6G8J55967D6281ACMKAKTEQ","crowd-prompting","A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.","https:\u002F\u002Fgithub.com\u002Fkbarbel640-del\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fzzadrian\u002Fcrowd-prompting\u002FSKILL.md",[58],{"categoryNo":59,"categoryName":60,"taxonomyType":61,"taxonomyTypeDesc":62},"01JBSEEDCAT000000000000036","内容创作者","PROFESSION","适用职业",[64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82],"crowd prompting","prompting","api","with","tokens","domain","world","prompts","operations","instructions","text","tool","system","improve","productivity","marketplace","https","content","ai agents",{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":94,"publishedAt":20},"01M6G8J0PKPAYVET6BWE8W4C26","dilemm-ai","Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).","https:\u002F\u002Fgithub.com\u002Fkbarbel640-del\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fzyori\u002Fdilemm-ai\u002FSKILL.md",[89],{"categoryNo":90,"categoryName":91,"taxonomyType":92,"taxonomyTypeDesc":93},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[95,66,96,97,98,99,100,101,102,103,104,105,106,107,108,109,110,71,111],"dilemm ai","arena","analyze","browser","openclaw agent","create","automation","browser automation","bot","openclaw","design","strategy","headless","compete","submit","matchmaking","use",{"skillNo":113,"name":114,"nameZh":6,"description":115,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":116,"categories":117,"keywords":121,"publishedAt":20},"01M6G8HWAF3K9SW7NP3Z83CPJ6","arxiv-paper-reviews","Interact with arXiv Crawler API to fetch papers, read reviews, and submit comments. Use when working with arXiv papers, fetching paper lists by date\u002Fcategory\u002Finterest, viewing paper details with comments, or submitting paper reviews via API at http:\u002F\u002F150.158.152.82:8000.","https:\u002F\u002Fgithub.com\u002Fkbarbel640-del\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fzxrys\u002Fweak-accept\u002FSKILL.md",[118],{"categoryNo":119,"categoryName":120,"taxonomyType":92,"taxonomyTypeDesc":93},"01JBSEEDCAT000000000000021","资料检索与研究",[122,123,124,125,126,127,128,67,129,109,111,130,66,131,132],"arxiv paper reviews","reviews","arxiv","paper","crawler","papers","comments","fetch","read","http","via",{"skillNo":134,"name":114,"nameZh":6,"description":115,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":135,"categories":136,"keywords":138,"publishedAt":20},"01M6G8HQJ7N7WMY6YV7D7SSJ16","https:\u002F\u002Fgithub.com\u002Fkbarbel640-del\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fzxrys\u002Farxiv-paper-reviews\u002FSKILL.md",[137],{"categoryNo":119,"categoryName":120,"taxonomyType":92,"taxonomyTypeDesc":93},[125,124,123,122,132,127,128,67,126,109,111,129,130,66,131],{"skillNo":140,"name":141,"nameZh":6,"description":142,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":143,"categories":144,"keywords":145,"publishedAt":20},"01M6G8HM95Y64JNVFC2HN4E2BG","git-summary","Get a quick summary of the current Git repository including status, recent commits, branches, and contributors.","https:\u002F\u002Fgithub.com\u002Fkbarbel640-del\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fzweack\u002Fgit-summary\u002FSKILL.md",[],[146,147,148,149,150,151,152,153,154,155,156,157,158],"git","summary","git summary","commits","repository","win32","status","linux","contributors","true","quick","get","branches",{"skillNo":160,"name":161,"nameZh":6,"description":162,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":163,"categories":164,"keywords":169,"publishedAt":20},"01M6G8HGEGF05CNEJCGVYFSC4R","agent-constitution","Interact with AgentConstitution governance contracts on Base Sepolia. Check compliance, read rules, log actions, query governance state.","https:\u002F\u002Fgithub.com\u002Fkbarbel640-del\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fztsalexey\u002Fagent-constitution\u002FSKILL.md",[165,166],{"categoryNo":90,"categoryName":91,"taxonomyType":92,"taxonomyTypeDesc":93},{"categoryNo":167,"categoryName":168,"taxonomyType":61,"taxonomyTypeDesc":62},"01JBSEEDCAT000000000000037","律师与法务",[170,171,172,173,67,174,175,24,176,130,177,178,179,180,181,80,182,183,184],"agent constitution","constitution","contracts","tree","query","base","log","check","Rules","projects","compliance","actions","state","governance","github"]