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#

text

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

Installation (OpenClaw)#

bash

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#

bash

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

Example:

bash

npm run get-link -- lnk_BUDBgiGTWejFs8v0FbdpR3iJ83CG1tua

Output format (JSON):

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#

FieldDescriptionEndpointGET /payment/link/:linkIdBase URLhttps://aipay.gstable.io/api/v1 (override via GSTABLE_API_BASE_URL)Parameterslink_id required, format lnk_xxxDocumentation[Get Payment Link

Agent Invocation Example#

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

bash

npm run get-link -- <link_id>

Conversation example:

text

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#

VariableRequiredDescriptionGSTABLE_API_BASE_URLNoAPI base URL, default https://aipay.gstable.io/api/v1

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