Accept Bitcoin payments with PayRam's self-hosted infrastructure. Unique mobile app signing flow for BTC transactions without server-side key exposure. HD wallet derivation for unlimited unique deposit addresses. Manual sweep approval via PayRam Merchant mobile app. Use when accepting Bitcoin payments, implementing BTC payment flows, needing self-custody Bitcoin infrastructure, or building Bitcoin payment acceptance without Lightning complexity.
Accept Bitcoin payments with PayRam's self-hosted infrastructure. Unique mobile app signing flow for BTC transactions without server-side key exposure. HD wallet derivation for unlimited unique deposit addresses. Manual sweep approval via PayRam Merchant mobile app. Use when accepting Bitcoin payments, implementing BTC payment flows, needing self-custody Bitcoin infrastructure, or building Bitcoin payment acceptance without Lightning complexity.
PayRam Bitcoin Payments
First time with PayRam? See payram-setup to configure your server, API keys, and wallets.
PayRam supports on-chain Bitcoin with a unique architecture: HD wallet derivation for deposits, mobile app signing for sweeps—no private keys ever touch the server.
Bitcoin vs EVM Architecture
Aspect
EVM Chains
Bitcoin
Deposit addresses
Smart contract generated
HD wallet derived
Sweep mechanism
Automated smart contract
Manual mobile app approval
Key storage
Keyless (contract-based)
Seed phrase on mobile only
Confirmation time
~15 sec - 2 min
~10-60 min
Setup Overview
Step 1: Configure Bitcoin in PayRam Dashboard
Navigate to Wallet Management → Bitcoin & Other Networks
Click Add Cold Wallet
Enter your Bitcoin cold wallet address (where funds will sweep to)
Step 2: Link Mobile App
The PayRam Merchant mobile app handles Bitcoin signing:
Download PayRam Merchant app (iOS/Android)
In PayRam dashboard: Settings → Accounts → Connect to PayRam Mobile App
Scan QR code with mobile app
Set up device passcode/biometrics
Step 3: Enter Seed Phrase (Mobile Only)
Open PayRam Merchant app
Select your configured BTC wallet
Click Link Wallet
Enter 12-word Bitcoin seed phrase
Security: Seed phrase is encrypted and stored only on your mobile device. Never transmitted to server.
Step 4: Approve Sweeps via Mobile
When deposits accumulate:
Open app → Signing Requests → Pending
Review batch: deposit addresses, amounts, fees
Approve batch to sweep funds to cold wallet
Monitor progress in In Progress tab
View completed sweeps in History
Payment Flow
1. Customer requests payment
2. PayRam derives unique BTC address from your seed (HD wallet)
3. Customer sends BTC to deposit address
4. PayRam detects transaction, waits for confirmations
5. Webhook fires: payment.pending → payment.successful
6. Deposits batch for sweep
7. You approve sweep in mobile app
8. Funds move to your cold wallet
Integration
Bitcoin payments use the same API as stablecoin/crypto payments:
const response = await axios.post(
`${PAYRAM_BASE_URL}/api/v1/payment`,
{
customerEmail: 'customer@example.com',
customerId: 'user_123',
amountInUSD: 50, // PayRam shows BTC equivalent
},
{ headers: { 'API-Key': PAYRAM_API_KEY } },
);
// User redirected to payment page// Can select Bitcoin as payment method
