https://github.com/profullstack/paybadge
A sleek, professional payment badge system for accepting cryptocurrency donations directly from your GitHub README files.
https://github.com/profullstack/paybadge
badges bitcoin crypto payments readme
Last synced: about 2 months ago
JSON representation
A sleek, professional payment badge system for accepting cryptocurrency donations directly from your GitHub README files.
- Host: GitHub
- URL: https://github.com/profullstack/paybadge
- Owner: profullstack
- Created: 2025-06-13T20:20:38.000Z (8 months ago)
- Default Branch: master
- Last Pushed: 2025-06-15T12:22:58.000Z (8 months ago)
- Last Synced: 2025-06-15T12:28:50.209Z (8 months ago)
- Topics: badges, bitcoin, crypto, payments, readme
- Language: HTML
- Homepage: http://paybadge.profullstack.com/
- Size: 11.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 💰 PayBadge - Crypto Payment Badge for GitHub
A sleek, professional payment badge system for accepting cryptocurrency donations directly from your GitHub README files.
[](https://paybadge.profullstack.com/?tickers=btc%2Ceth%2Csol%2Cusdc)
## 🚀 Quick Start
Add a crypto payment badge to your GitHub README by copying one of the code blocks below:
### Basic Payment Badge
```markdown
[](https://paybadge.profullstack.com/)
```
### Custom Single Cryptocurrency
```markdown
[](https://paybadge.profullstack.com/?ticker=btc)
```
## 📋 Supported Query Parameters
The payment system supports the following URL parameters for customization:
### 1. Single Cryptocurrency (`ticker`)
Restrict payments to a single cryptocurrency:
**Bitcoin Only:**
```markdown
[](https://paybadge.profullstack.com/?ticker=btc)
```
**Ethereum Only:**
```markdown
[](https://paybadge.profullstack.com/?ticker=eth)
```
**Solana Only:**
```markdown
[](https://paybadge.profullstack.com/?ticker=sol)
```
**USDC Only:**
```markdown
[](https://paybadge.profullstack.com/?ticker=usdc)
```
### 2. Multiple Cryptocurrencies (`tickers`)
Allow payments with multiple cryptocurrencies:
**Bitcoin and Ethereum:**
```markdown
[](https://paybadge.profullstack.com/?tickers=btc,eth)
```
**All Supported Cryptos:**
```markdown
[](https://paybadge.profullstack.com/?tickers=btc,eth,sol,usdc)
```
**Stablecoins Only:**
```markdown
[](https://paybadge.profullstack.com/?tickers=usdc)
```
### 3. Custom Recipient Address (`recipient_address`)
Use your own wallet address (works with single ticker only):
**Bitcoin with Custom Address:**
```markdown
[](https://paybadge.profullstack.com/?ticker=btc&recipient_address=bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh)
```
**Ethereum with Custom Address:**
```markdown
[](https://paybadge.profullstack.com/?ticker=eth&recipient_address=0x742d35Cc6634C0532925a3b8D4C9db96590c6C8b)
```
### 4. Multiple Custom Addresses (`recipient_addresses`)
Specify different addresses for different cryptocurrencies:
**Multiple Cryptos with Custom Addresses:**
```markdown
[](https://paybadge.profullstack.com/?tickers=btc,eth,usdc&recipient_addresses=btc:bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh,eth:0x742d35Cc6634C0532925a3b8D4C9db96590c6C8b,usdc:0x742d35Cc6634C0532925a3b8D4C9db96590c6C8b)
```
## 🎨 Badge Customization
### Different Badge Styles
You can create different badge styles for different purposes:
**Donation Badge:**
```markdown
[](https://paybadge.profullstack.com/?tickers=btc,eth)
```
**Support Badge:**
```markdown
[](https://paybadge.profullstack.com/?tickers=btc,eth,sol,usdc)
```
**Tip Badge:**
```markdown
[](https://paybadge.profullstack.com/?ticker=btc&recipient_address=your-btc-address)
```
## 🔧 Advanced Examples
### Complete Project Setup
Here's how you might set up payment badges for a complete project:
```markdown
# My Awesome Project
## Support This Project
If you find this project helpful, consider supporting it with cryptocurrency:
### Quick Donation
[](https://paybadge.profullstack.com/?tickers=btc%2Ceth%2Csol%2Cusdc)
### Specific Cryptocurrencies
| Cryptocurrency | Badge | Address |
|----------------|-------|---------|
| Bitcoin | [](https://paybadge.profullstack.com/?ticker=btc&recipient_address=bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh) | `bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh` |
| Ethereum | [](https://paybadge.profullstack.com/?ticker=eth&recipient_address=0x742d35Cc6634C0532925a3b8D4C9db96590c6C8b) | `0x742d35Cc6634C0532925a3b8D4C9db96590c6C8b` |
| USDC | [](https://paybadge.profullstack.com/?ticker=usdc&recipient_address=0x742d35Cc6634C0532925a3b8D4C9db96590c6C8b) | `0x742d35Cc6634C0532925a3b8D4C9db96590c6C8b` |
```
### Developer-Friendly Setup
For developers who want to make it easy for users to support their work:
```markdown
## 💝 Support Development
Love this project? Support continued development:
**One-Click Crypto Donation:**
[](https://paybadge.profullstack.com/?tickers=btc,eth,sol,usdc&recipient_addresses=btc:bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh,eth:0x742d35Cc6634C0532925a3b8D4C9db96590c6C8b,sol:9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM,usdc:0x742d35Cc6634C0532925a3b8D4C9db96590c6C8b)
**Prefer Bitcoin?**
[](https://paybadge.profullstack.com/?ticker=btc&recipient_address=bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh)
```
## 🌟 Supported Cryptocurrencies
| Symbol | Name | Default Address |
|--------|------|-----------------|
| `btc` | Bitcoin | `bc1q254klmlgtanf8xez28gy7r0enpyhk88r2499pt` |
| `eth` | Ethereum | `0x402282c72a2f2b9f059C3b39Fa63932D6AA09f11` |
| `sol` | Solana | `CsTWZTbDryjcb229RQ9b7wny5qytH9jwoJy6Lu98xpeF` |
| `usdc` | USD Coin | `0x402282c72a2f2b9f059C3b39Fa63932D6AA09f11` |
## 🔒 Security Features
- **QR Code Generation**: Automatic QR codes for mobile wallet scanning
- **Address Validation**: Built-in validation for wallet addresses
- **Secure Payment Flow**: No private keys or sensitive data stored
- **Blockchain Verification**: Real-time payment verification via blockchain APIs
## 📱 Mobile-Friendly
The payment interface is fully responsive and optimized for mobile devices, making it easy for supporters to donate from any device.
## 🛠️ Technical Details
- **Framework**: Vanilla JavaScript (ES2024+)
- **Styling**: Modern CSS with CSS Grid and Flexbox
- **QR Codes**: Dynamic generation using QRCode.js
- **Blockchain APIs**: Integration with major blockchain explorers
- **Accessibility**: Full ARIA support and keyboard navigation
## 📄 License
This project is open source and available under the [MIT License](LICENSE).
---
[](https://paybadge.profullstack.com/?tickers=btc%2Ceth%2Csol%2Cusdc)
**Made with ❤️ for the crypto community**