Near Getpay

HOT PAY Flow

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

🚀 Quick Start

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!

⚠️ Important Notes

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:

1. Sign up at https://admin.localhost.run/
2. Configure your custom domain
3. 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: