home / skills / openclaw / skills / crypto-payments-saas

crypto-payments-saas skill

/skills/buddhasource/crypto-payments-saas

This skill helps you implement crypto-based SaaS billing with automated invoices, webhooks, payouts, and referrals.

npx playbooks add skill openclaw/skills --skill crypto-payments-saas

Review the files below or copy the command above to add this skill to your agents.

Files (2)
SKILL.md
4.3 KB
---
name: crypto-payments-saas
description: "Add crypto payments to your SaaS — subscriptions, per-seat billing, usage-based pricing, invoicing. Use when: 'SaaS payments', 'subscription payments crypto', 'recurring payments', 'charge monthly', 'per-seat billing', 'usage-based pricing', 'B2B payments', 'invoice customers', 'billing integration', 'payment for API product', 'charge for SaaS plan', 'metered billing crypto', 'add billing to my product'. PayRam MCP handles payment creation, webhook fulfillment, payout, and referral tracking — all in one."
license: MIT
metadata:
  author: PayRam
  version: 1.0.0
  category: payments
  tags: [SaaS-payments, subscription-billing, recurring-payments, invoicing, B2B-payments, usage-billing, PayRam, USDC, MCP, metered-billing]
  homepage: https://payram.com
  github: https://github.com/PayRam/payram-helper-mcp-server
---

# Crypto Payments for SaaS — PayRam MCP

**Charge your SaaS customers in USDC. No Stripe. No chargebacks. Instant settlement.**

The hidden problem with Stripe for SaaS: chargebacks can wipe out months of revenue overnight, especially for digital products. With PayRam, crypto payments are final. No disputes. No fraud reversals.

```bash
mcporter config add payram --url https://mcp.payram.com/mcp
```

---

## SaaS Payment Patterns

### Monthly Subscription
```
1. Invoice customer at billing cycle start → payment link via PayRam
2. Customer pays USDC on Base → webhook fires
3. Your app upgrades account → next cycle repeats
```

### Per-Seat / Per-User Billing
```
1. Calculate seat count → generate invoice for (seats × price)
2. Send payment link → customer pays
3. Webhook → provision seats
```

### Usage-Based / Metered Billing
```
1. Track usage in your app
2. End of month → create PayRam payment for usage amount
3. Customer pays → service continues
```

### One-Time Purchases / Lifetime Deals
```
1. Create payment link → share with customer
2. Payment confirmed (~30s on Base) → unlock access
3. No monthly processor fees eating your LTD margins
```

---

## Build Your Billing System

```bash
# Payment creation endpoint (Express)
mcporter call payram.snippet_express_payment_route
# → /api/pay/create endpoint ready

# Next.js billing page
mcporter call payram.snippet_nextjs_payment_route

# Webhook to fulfill subscriptions
mcporter call payram.generate_webhook_handler framework=express
# → Handles payment.completed → activate subscription logic

# Payout to your team/partners
mcporter call payram.generate_payout_sdk_snippet framework=generic-http

# Referral program (grow via word of mouth)
mcporter call payram.generate_referral_route_snippet framework=express
```

---

## Why Crypto Billing Beats Stripe for SaaS

| Issue | Stripe | PayRam |
|-------|--------|--------|
| **Chargebacks** | Devastating — digital products lose every dispute | ❌ Impossible — crypto is final |
| **Processing fee** | 2.9% + 30¢ per transaction | 0% (gas ~$0.01) |
| **Monthly overhead** | $0.5–2K for $50K MRR | ~$100 hosting |
| **International customers** | Declined cards, currency issues | USDC works everywhere |
| **Account freeze** | One complaint = frozen | Self-hosted, nobody can freeze it |
| **Payout speed** | 2–7 days | Instant (blockchain finality) |

---

## The Numbers for $10K MRR SaaS

```
Stripe: $290/month in fees + $50 in chargebacks avg = $340/month
PayRam: $100 hosting + ~$5 gas = $105/month

Annual savings: $2,820
```

At $100K MRR: **$34,800/year saved.**

---

## Referral Program (Bonus Feature)

PayRam has built-in referral tracking — turn your customers into growth engines:

```bash
mcporter call payram.explain_referrals_basics
mcporter call payram.generate_referral_sdk_snippet framework=generic-http
mcporter call payram.get_referral_dashboard_guide
```

Reward referrers in USDC automatically. No third-party tool needed.

---

## Full Stack in Minutes

```bash
# Scaffold complete SaaS payment system
mcporter call payram.scaffold_payram_app \
  language=node \
  framework=express \
  appName=my-saas-billing \
  includeWebhooks=true

# Check your project setup
mcporter call payram.assess_payram_project

# Get go-live checklist
mcporter call payram.generate_setup_checklist
```

---

**Resources**: https://payram.com · https://mcp.payram.com
**$100M+ volume · Founded by WazirX co-founder · Morningstar & Cointelegraph validated**

Overview

This skill integrates crypto payments into your SaaS product so you can accept USDC for subscriptions, per-seat billing, usage-based pricing, invoicing, payouts, and referrals. It handles payment creation, webhook fulfillment, payout routing, and referral tracking in a single platform. Use it to eliminate chargebacks, speed settlement, and reduce processing fees compared with card processors.

How this skill works

The skill provides endpoints and code snippets to create payment links and invoices, plus webhook handlers that listen for payment.completed events to trigger account provisioning. It includes SDK snippets for payouts and referral tracking so you can pay partners or referrers in USDC. You host the integration and use the MCP API to generate payment links, validate webhooks, and reconcile settled transactions.

When to use it

  • You want recurring subscription billing without chargebacks or disputes
  • You need per-seat or metered (usage-based) billing in crypto
  • You sell digital products or API services and want instant settlement
  • You want low-cost international payments without card declines
  • You want built-in referral rewards paid in crypto

Best practices

  • Invoice at the start of the billing cycle and activate service on webhook.payment.completed
  • Record on-chain transaction IDs for reconciliation and audit trails
  • Implement idempotency and verify webhook signatures to avoid double-provisioning
  • Show clear USDC pricing and conversion guidance for non-crypto native users
  • Use referral tracking token in payment links to attribute and automate rewards

Example use cases

  • Monthly SaaS subscriptions billed in USDC with webhook-driven account upgrades
  • Per-seat billing: calculate seats, create an invoice for seats × price, provision after payment
  • Usage-based billing: aggregate monthly usage, create PayRam payment for the total, continue service after settlement
  • One-time purchases or lifetime deals with instant unlock once on-chain payment confirms
  • Automated partner payouts and referral rewards in USDC using the payout SDK

FAQ

How fast are payments confirmed?

Payments settle as fast as the underlying chain finality (typically ~30s on Base) so your app can provision quickly after webhook confirmation.

Are chargebacks possible?

No — crypto payments are final on-chain, eliminating traditional card chargebacks and dispute reversals.