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
| Field | Description |
|---|---|
| Endpoint | GET /payment/link/:linkId |
| Base URL | https://aipay.gstable.io/api/v1 (override via GSTABLE_API_BASE_URL) |
| Parameters | link_id required, format lnk_xxx |
| Documentation | [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:
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
| Variable | Required | Description |
|---|---|---|
GSTABLE_API_BASE_URL |
No | API 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