Payment Link Reader

A skill that fetches product information from a GStable Payment Link. It calls the GStable API - Get Payment Link endpoint and returns product details and supported payment methods.

Flow

Call API (GET /payment/link/:linkId)
        ↓
Return product info (name, description, price, payment tokens)

Installation (OpenClaw)

clawhub install payment-link-reader
cd ~/.openclaw/skills/payment-link-reader
npm install

For manual installation, copy the payment-link-reader directory to ~/.openclaw/skills/ or ./skills/, then run npm install.

Usage

# Fetch product info by link_id
npm run get-link -- <link_id>

Example:

npm run get-link -- lnk_BUDBgiGTWejFs8v0FbdpR3iJ83CG1tua

Output format (JSON):

{
  "linkId": "lnk_xxx",
  "linkName": "Premium Membership",
  "products": [
    {
      "name": "Premium Plan",
      "description": "Unlock all features",
      "imageUrl": "https://example.com/image.png",
      "quantity": 1,
      "unitPriceUSD": "1.00",
      "attributes": [{ "name": "Duration", "value": "1 Month" }]
    }
  ],
  "supportedPaymentTokens": [
    {
      "symbol": "USDC",
      "chainName": "Polygon",
      "chainId": "137",
      "amountInUSD": "3.00"
    }
  ]
}

API Reference

Agent Invocation Example

When the user provides a payment link or link_id, the Agent should run the following in the skill root directory:

npm run get-link -- <link_id>

Conversation example:

User: What's in this payment link lnk_BUDBgiGTWejFs8v0FbdpR3iJ83CG1tua?

Agent: [cd {baseDir} && npm run get-link -- lnk_BUDBgiGTWejFs8v0FbdpR3iJ83CG1tua]
       "This payment link contains: Premium Plan (1.00 USD each), supports USDC on Polygon, total 3.00 USD"

Note: {baseDir} is the skill directory path. Ensure npm install has been run before execution.

Environment Variables

Response Format

When responding to the user, summarize the payment link information in a readable format including:

• Product name
• Product description
• Unit price
• Supported payment tokens
• Blockchain network

Use Cases

• AI assistant parsing user-shared payment links
• Displaying product list from payment links
• Fetching supported chains and token info
• Validating link before payment