near-getpay

# 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:

1. **Beautiful UI** - Mobile-friendly payment page with preset amounts
2. **Multi-token** - Accept NEAR, USDC, or USDT
3. **Dual provider** - Works with PingPay or HOT PAY (or both)
4. **Public URL** - Exposes via localhost.run tunnel
5. **First-time friendly** - Setup wizard guides new users
6. **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)

## 🎨 User Flow

### PingPay Flow (default, best flow)
1. User selects token (NEAR, USDC, or USDT)
2. User enters amount or picks preset
3. Clicks "Pay Now"
4. Redirects to PingPay checkout with pre-filled amount

### 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

```bash
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`:

```bash
cp .env.example .env
```

Edit `.env`:

```env
# Display name (actual recipient is set in PingPay/HOT PA...

# 💳 NEAR GetPay - Crypto Payment Pages Made Easy

Accept cryptocurrency payments (NEAR, USDC, USDT) through a beautiful hosted payment page with PingPay or HOT PAY integration.

[![OpenClaw Skill](https://img.shields.io/badge/OpenClaw-Skill-blue)](https://openclaw.ai)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)

## 🌟 Features

- ✨ **Beautiful payment UI** - Mobile-responsive with preset amounts
- 💰 **Multi-token support** - Accept NEAR, USDC, or USDT
- 🔄 **Dual provider** - Works with PingPay or HOT PAY
- 🌐 **Public URLs** - Automatic tunnel via localhost.run
- 🧙 **Setup wizard** - Guides first-time users step-by-step
- 🔒 **Secure** - No private keys needed, HTTPS enforced
- 🎯 **Smart token selection** - Once token selected, other options hide (HOT PAY flow)

## 💡 How It Works

### PingPay Flow
1. User selects token (NEAR/USDC/USDT)
2. Enters amount or picks preset
3. Clicks "Pay Now" → Redirects to PingPay checkout

### HOT PAY Flow
1. User sees only configured tokens (those with item_ids)
2. Selects token → **Other tokens hide automatically**
3. Enters amount → Redirects to specific HOT PAY link for that token
4. Each token has its own checkout URL (configured in HOT PAY dashboard)

## 🚀 Quick Start

### 1. Clone & Install

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

### 2. Configure Provider

**Choose ONE (or both):**

#### Option A: PingPay (Recommended)

1. Sign up at [pingpay.io](https://pingpay.io)
2. Set your NEAR wallet in Dashboard → Settings
3. Get API key from Dashboard → Settings → API Keys
4. Add to `.env`:

```env
RECIPIENT_ADDRESS=your-account.near
PAYMENT_PROVIDER=pingpay
PINGPAY_API_KEY=your_api_key_here
```

#### Option B: HOT PAY

1. Visit [HOT PAY Admin](https://pay.hot-labs.org/admin/overview)
2. Create payment links for each token (NEAR, USDC, USDT)
3. Set your NEAR wallet as recipient for each l...