# Send Near Getpay - Accept crypto payments  with payment page using PingPay or HOT PAY to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "near-getpay",
    "name": "Near Getpay - Accept crypto payments  with payment page using PingPay or HOT PAY",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/cuongdcdev/near-getpay",
    "canonicalUrl": "https://clawhub.ai/cuongdcdev/near-getpay",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/near-getpay",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=near-getpay",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "server-simple.ts",
      "SKILL.md",
      "skill.json",
      "package-lock.json",
      "tsconfig.json",
      "server.ts"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/near-getpay"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/near-getpay",
    "downloadUrl": "https://openagent3.xyz/downloads/near-getpay",
    "agentUrl": "https://openagent3.xyz/skills/near-getpay/agent",
    "manifestUrl": "https://openagent3.xyz/skills/near-getpay/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/near-getpay/agent.md"
  }
}
```
## Documentation

### NEAR GetPay Skill

Accept crypto payments (NEAR, USDC, USDT) via a beautiful payment page with PingPay or HOT PAY integration.

### 🎯 What It Does

Creates a hosted payment page where people can pay you in crypto with just a few clicks:

Beautiful UI - Mobile-friendly payment page with preset amounts
Multi-token - Accept NEAR, USDC, or USDT
Dual provider - Works with PingPay or HOT PAY (or both)
Public URL - Exposes via localhost.run tunnel
First-time friendly - Setup wizard guides new users
Smart token selection - Once a token is selected, others are hidden to avoid confusion (great for HOT PAY where each token has a unique checkout link)

### PingPay Flow (default, best flow)

User selects token (NEAR, USDC, or USDT)
User enters amount or picks preset
Clicks "Pay Now"
Redirects to PingPay checkout with pre-filled amount

### HOT PAY Flow

User selects token (only configured tokens shown)
Other tokens are hidden to avoid confusion
User enters amount or picks preset
Clicks "Pay Now"
Redirects to HOT PAY checkout link for that specific token and amount

### 1. Installation

cd ~/.openclaw/skills
# Clone or extract the skill
npm install

### 2. Choose Your Provider

You need either PingPay or HOT PAY (or both):

Option A: PingPay (recommended for beginners)

Sign up at https://pingpay.io
Set your NEAR wallet in Dashboard → Settings
Get API key from Dashboard → Settings → API Keys
Add to .env: PINGPAY_API_KEY=your_key_here

Option B: HOT PAY (for advanced users)

Visit https://pay.hot-labs.org/admin/overview
Create payment links for each token (NEAR, USDC, USDT)
Set your NEAR wallet as recipient when creating each link
Copy each item_id and add to .env

### 3. Configure

Copy .env.example to .env:

cp .env.example .env

Edit .env:

# Display name (actual recipient is set in PingPay/HOT PAY dashboard!)
RECIPIENT_ADDRESS=your-account.near

# Choose provider
PAYMENT_PROVIDER=pingpay  # or 'hotpay'

# PingPay config (if using PingPay)
PINGPAY_API_KEY=your_api_key_here

# HOT PAY config (if using HOT PAY)
HOTPAY_NEAR_ITEM_ID=your_near_item_id
HOTPAY_USDC_ITEM_ID=your_usdc_item_id
HOTPAY_USDT_ITEM_ID=your_usdt_item_id

### 4. Start Server

./start.sh

Or manually:

npx ts-node start-tunnel.ts

This will:

Start Express server on port 3000
Create public URL via localhost.run
Display the shareable payment link

### 5. Share Your Link

Share the generated https://xxxxx.lhr.life URL to accept payments!

### Recipient Address Configuration

The recipient address (where payments go) is configured at the provider level, NOT in the .env file:

PingPay: Set in your PingPay Dashboard → Settings → Wallet Address
HOT PAY: Set when creating each payment link

The RECIPIENT_ADDRESS in .env is only for display on the payment page. To change where payments actually go, update your provider's dashboard settings.

### Tunnel Domains

localhost.run generates random URLs that change each restart. For a permanent domain:

Sign up at https://admin.localhost.run/
Configure your custom domain
Update the tunnel command in start-tunnel.ts

Or use your own reverse proxy (Cloudflare Tunnel, ngrok paid, etc.)

### 📖 Usage in OpenClaw

When a user asks to accept payments:

User: "Create a payment page to accept USDT donations"

Agent:
1. Check if near-getpay skill is installed
2. Ask which provider they want (PingPay or HOT PAY)
3. Guide them through setup if not configured
4. Run: cd ~/.openclaw/skills/near-getpay && ./start.sh
5. Share the generated public URL

### Example Conversation

User: I need to accept crypto payments

Agent: I'll set up a payment page for you using the GetPay skill.

First, do you have a PingPay or HOT PAY account?

User: No, what's easier?

Agent: PingPay is simpler. Here's what to do:

1. Sign up at https://pingpay.io
2. Add your NEAR wallet address in settings
3. Get an API key from Dashboard → API Keys
4. Share it with me (or add to .env yourself)

Let me know when you have the API key!

User: Got it: sk_test_abc123...

Agent: Perfect! Starting your payment server...

[runs start.sh]

✅ Your payment page is live:
https://abc123xyz.lhr.life

Share this link to accept NEAR, USDC, or USDT payments!

### 🛠️ File Structure

near-getpay/
├── SKILL.md              ← You are here
├── package.json
├── tsconfig.json
├── .env.example          ← Config template
├── .env                  ← Your config (gitignored)
├── start.sh              ← Quick start script
├── start-tunnel.ts       ← Server + tunnel launcher
├── server-simple.ts      ← Main payment server
└── scripts/
    ├── pingpay-client.ts
    └── payment-orchestrator.ts

### Custom Port

Edit .env:

PORT=8080

### Custom Tunnel

Replace localhost.run in start-tunnel.ts:

// Option 1: ngrok
const tunnel = spawn('ngrok', ['http', PORT.toString()]);

// Option 2: Cloudflare Tunnel
const tunnel = spawn('cloudflared', ['tunnel', '--url', \`http://localhost:${PORT}\`]);

// Option 3: localtunnel (less reliable)
const tunnel = spawn('npx', ['localtunnel', '--port', PORT.toString()]);

### Webhook Integration (HOT PAY only)

HOT PAY sends webhooks to /webhook/hotpay. To use:

Expose your server publicly (not localhost.run - needs stable URL)
Configure webhook URL in HOT PAY dashboard
Server logs payment confirmations automatically

### Payment Amounts

Edit preset amounts in server-simple.ts:

tokens: [
  {
    symbol: 'NEAR',
    chain: 'NEAR',
    decimals: 24,
    presets: [0.5, 1, 5, 10]  // ← Change these
  },
  // ...
]

### Branding

Update colors, fonts, text in the HTML template sections of server-simple.ts.

### Add More Tokens

Add to the tokens array (requires provider support):

{
  symbol: 'ETH',
  chain: 'NEAR',
  decimals: 18,
  presets: [0.01, 0.05, 0.1, 0.5]
}

### "No provider configured"

Visit http://localhost:3000/setup to see setup instructions.

### "Permission denied (publickey)" (localhost.run)

Run: ssh-keygen -t rsa -b 2048 -f ~/.ssh/id_rsa -N ""

### "Tunnel closed"

localhost.run tunnels timeout after inactivity. Restart the server.

### "Token not configured" (HOT PAY)

You need to create a payment link for each token. Missing tokens won't appear on the payment page.

### Provider returning errors

PingPay: Check API key is valid and account is active
HOT PAY: Verify item_ids match your created links

### 🔐 Security

✅ API keys stored in .env (gitignored)
✅ No private keys needed (payments go directly to provider)
✅ HTTPS via tunnel
✅ Webhook signature verification (HOT PAY)

Never commit .env to git!

### As a Skill Package

# From the skill directory
openclaw skill pack

# Share the .skill file
# Users install with: openclaw skill install near-getpay.skill

### Via GitHub

git init
git add .
git commit -m "Initial commit: NEAR GetPay skill"
git remote add origin https://github.com/yourusername/near-getpay.git
git push -u origin main

Users install with:

cd ~/.openclaw/skills
git clone https://github.com/yourusername/near-getpay.git
cd near-getpay
npm install

### Via Clawhub

Visit https://clawhub.com
Upload the .skill package
Add description and tags
Publish!

### 🤝 Support

Issues: GitHub Issues (if published)
PingPay: https://pingpay.io/docs
HOT PAY: https://pay.hot-labs.org/admin
OpenClaw: https://docs.openclaw.ai

### 📝 License

MIT

Made for OpenClaw 🐾
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: cuongdcdev
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/near-getpay)
- [Send to Agent page](https://openagent3.xyz/skills/near-getpay/agent)
- [JSON manifest](https://openagent3.xyz/skills/near-getpay/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/near-getpay/agent.md)
- [Download page](https://openagent3.xyz/downloads/near-getpay)