Skip to main content
Start accepting stablecoin payments by your next coffee break. Book a call
For developers

Setup PayRam. Three ways.

One bash script. One LLM prompt. Or the advanced guide. Pick the path that fits how you ship — or let an agent do the whole install for you. Five minutes on any Ubuntu VPS, no signup, no KYB.

Ready to run on any Ubuntu VPS
One-line install
bash <(curl -fsSL https://payram.com/setup_payram.sh)
Pick your install path

Ship how you ship.

Whether you're the dev, the agent, or the platform team — there's a path. Same PayRam runs underneath; you control the deployment surface.

Option 1 · simple

The one-liner.

For devs who just want PayRam running. Copy this into a terminal on a fresh Ubuntu 22.04+ VPS. Five minutes, web dashboard included.

Bash
bash <(curl -fsSL https://payram.com/setup_payram.sh)
View the script source
Option 2 · agents

Let your agent install it.

Paste this prompt into ChatGPT, Claude, Copilot, Cursor, OpenClaw, or any MCP-capable agent. The agent will ask you a few questions, pick testnet or mainnet, and run the headless install.

Agent prompt
Set up PayRam as a self-hosted crypto payment gateway on my machine.

Before you begin, ask me:
  1. Is this a remote VPS or my local machine?
  2. Do I need testnet or mainnet?
  3. Which stablecoin do I want to accept first (USDT on Tron, USDC on Base, or a different chain)?

Then run the headless agent install:
  bash <(curl -fsSL https://payram.com/setup_payram_agents.sh)

Use https://mcp.payram.com as the MCP server for tools and documentation —
register it in your MCP config as:
  { "mcpServers": { "payram": { "url": "https://mcp.payram.com/mcp" } } }

Walk me through each step, confirm each prerequisite before continuing,
and verify the install succeeded by calling the test_connection tool.
Agent install script
Option 3 · advanced

Custom deployments.

Docker compose, systemd, custom TLS, multi-region, staging environments, HA, custom chains. The full deployment reference on docs.payram.com.

Docker Compose reference
systemd unit files
Custom TLS + reverse proxy
Multi-region & HA setups
Chain RPC configuration
Read the advanced guide

Prerequisites — minimal.

Seed never leaves the hardware wallet. Server only holds a read-only xPub.

OS
Ubuntu 22.04+
CPU
2 (4 recommended)
RAM
6 GB (8 recommended)
Disk
15 GB+
Domain
Pointed at VPS
Wallet
xPub from hardware
Stuck?

Let an LLM debug it with you.

Copy this prompt, paste into ChatGPT, Claude, Copilot, or any MCP-capable client. It reads the install script, asks about your environment, and walks you through a fix using mcp.payram.com for known issues.

  • Reads the install script for full context
  • Asks about your OS, hardware, and network
  • References the MCP server for known issues
  • Guides reproduction + resolution step-by-step
Troubleshoot prompt
I'm installing PayRam using the official script:
  https://payram.com/setup_payram.sh

First, fetch and read the content of that script so you have the full context
of what it does.

Then ask me about:
  - My operating system and version
  - Hardware (CPU, RAM, disk) and whether this is a local machine or VPS
  - My network setup (firewall, domain, SSL)
  - The exact step I'm stuck at
  - The exact error message (copy-paste verbatim)

Use https://mcp.payram.com as a reference for known issues, tools, and the
full MCP skill catalog. If useful, have the agent call test_connection
or relevant diagnostic tools.

Walk me through a minimal reproduction and resolution. Don't guess —
ask clarifying questions until you're confident about my environment.

Works in ChatGPT · Claude · Copilot · Cursor · OpenClaw · any MCP client

Integrate

One script tag. Live payments.

Drop the Add Credit widget on any page — HTML, React, WordPress, static site. Customers see a clean 3-step flow, pay with crypto or card-to-crypto, and you receive a webhook. Prefer full control? Use the REST API or call the MCP server directly.

Live demo — try it
PayRamDEMO
Step 1 · Add credit

Add Credit

Choose an amount to add to your demo account.

$

Same widget. Configured for the PayRam sandbox. Amount selection → test funds → payment confirmed.

HTML
<script
  src="https://payram.com/widget/payram-add-credit-v1.js"
  data-payram-url="https://your-payram-node.com"
  data-api-key="pr_live_xxxxxxxxxxxxx"
  data-amounts="5,10,25,50,100"
  data-theme="dark"
  data-brand-label="Your Brand"
  data-currency="USDC"
  data-chain="base">
</script>

Drop into <body> wherever the widget should mount. Configure via data attributes — data-amounts, data-theme, data-chain. Handle the payment.confirmed webhook on your server.

Native examples forExpressNext.jsFastAPILaravelGinSpring Boot
Go deeper

Explore the full documentation.

API reference, webhook contracts, deployment topologies, RPC configuration, multi-region setups, SSL guidance, disaster recovery — the definitive technical manual lives at docs.payram.com.

Explore docs

Supported Chains & Tokens

20+ tokens across 6 networks. Stablecoin-native — USDT and USDC on every supported chain.

Bitcoin
Bitcoin
BTC
Variable · ~10 min
Ethereum
Ethereum
ETH
~$1–5 · ~15 sec
Tron
Tron
TRX
~$0.01 · ~3 sec
Base
Base
BASE
~$0.01 · ~2 sec
Polygon
Polygon
POL
~$0.01 · ~5 sec
SoonSolana
Solana
SOL
~$0.001 · ~0.4 sec
Primary stablecoins:
USDTUSDT
USDCUSDC
+ BTC, ETH, TRX, and 15 more

Setup questions.

Which install script should I run?+
setup_payram.sh for the full install with the web dashboard — the default for most people. setup_payram_agents.sh for a headless, CLI-only install that an autonomous agent can drive end-to-end.
Do I need to sign up or create an account?+
No. PayRam is self-hosted infrastructure software. There is no PayRam account, no KYB, no approval process. You own the VPS and the cold wallet.
What happens if my server is compromised?+
Deposit wallet keys never touch the server. PayRam uses a read-only xPub and a smart contract with a hardcoded cold-wallet destination. A full server compromise yields zero spendable funds — there are no keys to steal.
Can an AI agent install PayRam autonomously?+
Yes. The agent install script is designed for it. Feed the agent prompt on this page to any MCP-capable client (Claude, Copilot, OpenClaw, Cursor, n8n) and it will walk through the whole install with your confirmation at each step.
How do I integrate PayRam into my web app?+
Drop the payram-add-credit-v1.js script tag on any page, handle the payment.confirmed webhook on your server, done. Full code examples for Express, Next.js, FastAPI, Laravel, and Gin are on the widget integration skill.
What if the install script fails?+
Copy the troubleshooting prompt above into any LLM. It asks the assistant to read the install script first, ask about your environment, and walk you through a fix. Jump there ↑