🤖 Integrating Bitcoin Payments in RAHIM VIP BOT with Blockonomics
Bitcoin payments are fast, secure, and decentralized—ideal for handling transactions. In RAHIM VIP BOT I integrated Blockonomics to ensure each payment request gets a unique Bitcoin address, preventing abuse and enhancing user experience.
👇 Here’s how it works!
🏗️ System Overview
The payment system in RAHIM VIP BOT involves three key players:
🟢 Telegram Client (RAHIM VIP BOT) – Sends payment requests and displays payment details to users.
🟠 Backend API – Validates requests, generates Bitcoin addresses, and confirms payments.
🔵 Blockonomics API – Provides fresh Bitcoin addresses and sends payment status updates.
💳 Creating a Bitcoin Payment Request
When a user requests a payment in RAHIM VIP BOT:
1️⃣ The backend checks for unpaid payments.
- If an unpaid payment exists, the same details are resent to avoid duplicate transactions.
- If no payment exists, a new payment is created with a fresh Bitcoin address.
2️⃣ A new address is generated via the Blockonomics API:
curl -X POST https://www.blockonomics.co/api/new_address \
-H "Authorization: Bearer INSERT_API_KEY_HERE"3️⃣ The BTC amount is calculated based on the latest exchange rate.
📌 This ensures each payment has a dedicated address, preventing duplicate requests.
🚨 Preventing Payment Spam
To prevent abuse, RAHIM VIP BOT follows these rules:
✅ Only one active payment per user – If they have a pending one, they must pay or wait for it to expire.
✅ Payments expire after 15 minutes, clearing abandoned transactions.
🔄 Converting Plan Prices to BTC
Since BTC prices fluctuate, the backend stores a satoshis per USD rate, which updates every 15 minutes.
1️⃣ The latest BTC exchange rate is retrieved.
2️⃣ The plan price (in cents) is converted to USD.
3️⃣ The BTC amount is calculated.
// Fetch the current exchange rate from USD to satoshis for Bitcoin
const { satoshisPerUsd } = await CoinsService.getSatoshisPerCent('Bitcoin');
// Convert the plan price from cents to USD
const priceInUsd = Money.centsToUsd(priceInCents);
// Calculate the requested Bitcoin amount in satoshis based on the current exchange rate
const requestedAmount = Math.round(satoshisPerUsd * priceInUsd);📩 Handling Payment Callbacks
Once a user completes the payment, Blockonomics sends an HTTP callback to update the payment status.
📊 Callback Parameters:
🟢 status – 0 (Unconfirmed), 1 (Partially Confirmed), 2 (Confirmed)
🟢 addr – The Bitcoin address that received the payment
🟢 value – Payment amount in satoshis
🟢 txid – Transaction ID
Example of a successful payment callback, confirming the payment and showing feedback to the user.
🎟️ Granting Access After Payment
Once the payment is confirmed (status = 2), RAHIM VIP BOT automatically grants the user access to the private VIP channel.
1️⃣ The backend verifies the payment and adds the user to the group.
2️⃣ A success message is sent to the user.
🔐 Security Best Practices
🚀 Validate the secret key in Blockonomics callbacks to prevent unauthorized requests.
🚀 Wait for at least one confirmation before granting access.
🚀 Use a fresh Bitcoin address per transaction for better tracking.
🚀 Limit unpaid payment requests to avoid abuse.
🏁 Conclusion
By integrating Blockonomics, RAHIM VIP BOT now supports secure and efficient Bitcoin payments. This setup ensures smooth transactions while preventing users from spamming multiple unpaid requests.
⚡ Want to integrate Bitcoin payments in your project? This method is a solid approach!