recur-skills 0.0.9 → 0.0.10

package/.claude-plugin/marketplace.json

@@ -2,7 +2,7 @@
   "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
   "name": "recur-skills",
   "description": "Claude Code skills for integrating Recur — Taiwan's subscription payment platform",
-  "version": "0.0.9",
+  "version": "0.0.10",
   "owner": {
     "name": "Recur",
     "email": "hi@recur.tw",
@@ -10,14 +10,14 @@
   },
   "metadata": {
     "description": "Claude Code skills for integrating Recur - Taiwan's subscription payment platform",
-    "version": "0.0.9"
+    "version": "0.0.10"
   },
   "plugins": [
     {
       "name": "recur-skills",
       "displayName": "Recur Skills",
       "description": "Skills for Recur SDK integration (quickstart, checkout, webhooks, entitlements, portal) and the Recur MCP server for signup, API keys, and products",
-      "version": "0.0.9",
+      "version": "0.0.10",
       "source": "./",
       "category": "development",
       "homepage": "https://docs.recur.tw/guides/skills",

package/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "recur-skills",
   "displayName": "Recur Skills",
-  "version": "0.0.9",
+  "version": "0.0.10",
   "description": "Skills for Recur SDK integration (quickstart, checkout, webhooks, entitlements, customer portal) plus the Recur MCP server (https://mcp.recur.tw/) for account signup, API keys, and products.",
   "author": {
     "name": "Recur",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "recur-skills",
-  "version": "0.0.9",
+  "version": "0.0.10",
   "description": "Claude Code skills and MCP plugin for Recur - Taiwan's subscription payment platform",
   "keywords": [
     "recur",

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "recur-skills",
-  "version": "0.0.9",
+  "version": "0.0.10",
   "description": "Skills for Recur SDK integration: quickstart, checkout, webhooks, entitlements, and customer portal. Taiwan subscription billing via PAYUNi.",
   "author": {
     "name": "Recur",

package/skills/recur-checkout/SKILL.md

@@ -4,7 +4,7 @@ description: Implement Recur checkout flows including embedded, modal, and redir
 license: MIT
 metadata:
   author: recur
-  version: "0.0.9"
+  version: "0.0.10"
 ---
 
 # Recur Checkout Integration
@@ -203,9 +203,11 @@ onPaymentFailed: (error) => {
 
 For server-rendered apps or custom flows:
 
+Product IDs are CUIDs from `list_products` / the dashboard (e.g. `cmfxq8n2a0001l8yz3k5p9t7d`); `prod_xxx` is a placeholder.
+
 ```typescript
 // Create checkout session
-const response = await fetch('https://api.recur.tw/v1/checkouts', {
+const response = await fetch('https://api.recur.tw/v1/checkout/sessions', {
   method: 'POST',
   headers: {
     'X-Recur-Secret-Key': process.env.RECUR_SECRET_KEY,
@@ -219,8 +221,10 @@ const response = await fetch('https://api.recur.tw/v1/checkouts', {
   }),
 })
 
-const { checkoutUrl } = await response.json()
-// Redirect user to checkoutUrl
+// The session object is the response body itself (no outer `data` wrapper, snake_case keys)
+const { url } = await response.json()
+// Redirect the customer to `url` — the hosted checkout page.
+// (/v1/checkouts is the embedded-form endpoint and returns a different shape.)
 ```
 
 ## Checkout Result Structure

package/skills/recur-entitlements/SKILL.md

@@ -4,7 +4,7 @@ description: Implement access control and permission checking with Recur entitle
 license: MIT
 metadata:
   author: recur
-  version: "0.0.9"
+  version: "0.0.10"
 ---
 
 # Recur Entitlements & Access Control
@@ -71,7 +71,7 @@ const { check } = useCustomer()
 // Check by product slug
 const { allowed, entitlement } = check('pro-plan')
 
-// Check by product ID
+// Check by product ID (a CUID from list_products, e.g. 'cmfxq8n2a0001l8yz3k5p9t7d'; 'prod_xxx' is a placeholder)
 const { allowed } = check('prod_xxx')
 
 if (allowed) {

package/skills/recur-help/SKILL.md

@@ -4,7 +4,7 @@ description: List all available Recur skills and how to use them. Use when user
 license: MIT
 metadata:
   author: recur
-  version: "0.0.9"
+  version: "0.0.10"
 ---
 
 # Recur Skills 使用指南

package/skills/recur-portal/SKILL.md

@@ -4,7 +4,7 @@ description: Implement Customer Portal for subscription self-service. Use when b
 license: MIT
 metadata:
   author: recur
-  version: "0.0.9"
+  version: "0.0.10"
 ---
 
 # Recur Customer Portal Integration

package/skills/recur-quickstart/SKILL.md

@@ -4,7 +4,7 @@ description: Quick setup guide for Recur payment integration, from account signu
 license: MIT
 metadata:
   author: recur
-  version: "0.0.9"
+  version: "0.0.10"
 ---
 
 # Recur Quickstart
@@ -34,9 +34,10 @@ OAuth flow**, so make sure the `recur` MCP server is connected. Pick ONE:
 
 Before the first tool call, tell the user what will happen:
 
-> A browser window will open. Log in, or click **註冊** (Sign up) on the login
-> page to create a Recur account, then approve the connection. New accounts
-> start in sandbox mode.
+> A browser window will open. Log in, or click **建立新帳號** (Create account) on
+> the login page to create a Recur account, then approve the connection. Keep
+> the default scopes — Step 0 needs `api-keys:write` and `products:write`.
+> New accounts start in sandbox mode.
 
 Then, through MCP:
 

package/skills/recur-webhooks/SKILL.md

@@ -4,7 +4,7 @@ description: Set up and handle Recur webhook events for payment notifications. U
 license: MIT
 metadata:
   author: recur
-  version: "0.0.9"
+  version: "0.0.10"
 ---
 
 # Recur Webhook Integration