Obverse Payments

---

name: obverse-payments description: End-to-end stablecoin payments — links, invoices, receipts, dashboards — across Telegram, WhatsApp, Discord homepage: https://www.obverse.cc user-invocable: true metadata: openclaw: requires: env: ["OBVERSE_API_KEY"] primaryEnv: "OBVERSE_API_KEY"

---

Obverse - Stablecoin Payments for AI Agents

One generic payment link. Multiple use cases.

Accept Stablecoin (USDC) payments on Solana and Monad for any purpose: selling products, fundraising, invoicing, or simple payments.

What This Skill Does

✅ Create Payment Links - One flexible payment link for all use cases ✅ Collect Customer Data - Gather email, name, phone, or ANY custom fields you need ✅ Dashboard Analytics - Get detailed payment stats, customer lists, and charts ✅ Accept Stablecoin Payments - USDC on Solana and Monad blockchains ✅ Track Everything - Sales analytics, fundraising progress, payment history ✅ Multi-Platform - Works via Telegram, WhatsApp, Discord, and more ✅ Low Fees - 0.5-1.5% per transaction (vs 2.9% for Stripe) ✅ Instant Settlement - Funds in your wallet within minutes

---

Quick Setup

1. Register & Get API Key

# Register from any platform (no Telegram required!)
curl -X POST https://obverse.onrender.com/api-keys/register \
  -H "Content-Type: application/json" \
  -d '{"username": "your-agent-name"}'
With your own wallet:
curl -X POST https://obverse.onrender.com/api-keys/register \
  -H "Content-Type: application/json" \
  -d '{"username": "your-agent-name", "walletAddress": "YOUR_WALLET", "chain": "solana"}'

Response includes your API key (obv_sk_...) and wallet address. Save the key — it's shown only once!

2. Set Environment Variables

export OBVERSE_API_KEY="obv_sk_your_key_here"
export OBVERSE_API_URL="https://obverse.onrender.com"  # optional, this is the default

3. Start Using

# Create a payment link
obverse-cli create-link 50 USDC solana "My first payment"

---

Three Main Use Cases

1. 🛍️ Product/Service Sales (Merchant Sales)

Sell products or services to anyone with a payment link. Automatically collects customer email and name for your mailing list!

Example: Selling Running Shoes

# Create product payment link (auto-collects email & name)
obverse-cli create-product-link "Premium Running Shoes" 120 USDC solana "High-performance shoes"
Returns:
{
  "paymentUrl": "https://www.obverse.cc/pay/shoe-xyz",
  "linkCode": "shoe-xyz",
  "type": "product_sale",
  "title": "Premium Running Shoes",
  "amount": 120,
  "token": "USDC",
  "customFields": [
    { "fieldName": "email", "fieldType": "email", "required": true },
    { "fieldName": "name", "fieldType": "text", "required": true }
  ],
  "message": "Collects customer email and name!"
}
Generate dashboard link to view all customer data
obverse-cli generate-dashboard shoe-xyz
Returns:
{
  "dashboardUrl": "https://www.obverse.cc/dashboard",
  "credentials": {
    "username": "@yourname",
    "password": "AbC123XyZ456"
  },
  "instructions": [
    "1. Open dashboard: https://www.obverse.cc/dashboard",
    "2. Login with your credentials",
    "3. View customer emails, names, and payment details!"
  ]
}
Check sales analytics
obverse-cli get-analytics shoe-xyz
List all customers with their data
obverse-cli list-contributors shoe-xyz 50

Perfect For:

Physical products (clothing, gadgets, merch)

Digital products (ebooks, courses, templates)

Services (consulting, development, design)

Event tickets, subscriptions, pre-orders

---

2. 💰 Crowdfunding/Fundraising

Raise money from multiple contributors for a shared goal.

Example: Funding AI Development

# Create fundraising campaign
obverse-cli create-fundraiser "AI Development Fund" 5000 USDC monad "Building advanced AI agents"
Returns:
{
  "paymentUrl": "https://www.obverse.cc/pay/fund-xyz",
  "linkCode": "fund-xyz",
  "type": "crowdfunding",
  "goalAmount": 5000
}
Check fundraising progress
obverse-cli check-progress fund-xyz 5000
Returns:
{
  "fundraising": {
    "goalAmount": 5000,
    "raisedAmount": 3450,
    "remainingAmount": 1550,
    "progressPercent": "69.0",
    "contributors": 23
  }
}
List all contributors
obverse-cli list-contributors fund-xyz

Perfect For:

Agent development funding

Product launches

Community projects

Research funding

Open source projects

Bounty programs

---

3. 💳 Simple Payments & Invoicing

Accept one-time payments or create invoices for clients.

Example: Consulting Invoice

# Generic payment link (one-time use)
obverse-cli create-link 750 USDC solana "Consulting Services - 5 hours"
Check if paid
obverse-cli check-payment xyz123
List all payments
obverse-cli list-payments xyz123

Or use formal invoicing:

# Create invoice with recipient details
obverse-cli create-invoice john@example.com 750 USDC monad

Perfect For:

Freelance work

Professional services

One-time payments

Tips and donations

---

🎯 NEW: Data Collection & Dashboard Features

Collect Customer Data with Payment Links

Every payment link can now collect custom data from customers! Perfect for building mailing lists, gathering customer info, and invoicing.

# Simple example: Collect email and phone number
obverse-cli create-link 50 USDC solana "Consultation Fee" '[{"fieldName":"email","fieldType":"email","required":true},{"fieldName":"phone","fieldType":"tel","required":false}]' true
Product sales automatically collect email & name
obverse-cli create-product-link "Digital Course" 299 USDC monad
Fundraising automatically collects optional contributor info
obverse-cli create-fundraiser "Community Project" 10000 USDC solana

Custom fields you can collect:

Email addresses (fieldType: "email")

Names (fieldType: "text")

Phone numbers (fieldType: "tel")

Messages (fieldType: "textarea")

Company names, addresses, or ANY text field you need!

Dashboard Analytics

Get a full dashboard with payment analytics and customer data!

# Generate dashboard credentials for any payment link
obverse-cli generate-dashboard shoe-xyz
Returns login credentials:
{
  "dashboardUrl": "https://www.obverse.cc/dashboard",
  "credentials": {
    "username": "@yourname",
    "password": "AbC123XyZ456",  // Valid for 2 hours
    "expiresAt": "2024-01-15T12:30:00.000Z"
  },
  "instructions": [
    "1. Open dashboard",
    "2. Login with credentials",
    "3. View analytics, customer emails, payment history, charts"
  ]
}

What you get in the dashboard:

📊 Payment statistics (total revenue, count, success rate)

📧 Customer data (emails, names, all collected fields)

📈 Charts and trends over time

🔍 Searchable payment history

💾 Export customer lists

---

Core Commands

Creating Payment Links

# Generic payment link with optional custom fields
obverse-cli create-link  [currency] [chain] [description] [customFieldsJson] [isReusable]
Example: Simple payment
obverse-cli create-link 50 USDC solana "Payment for services"
Example: With data collection
obverse-cli create-link 100 USDC monad "Consultation" '[{"fieldName":"email","fieldType":"email","required":true}]' true

Convenience Wrappers (Auto-collect customer data!)

# For product/service sales (auto-collects email & name)
obverse-cli create-product-link