Add-ons Crypoverse - Cryptocurrency Payment Gateway [BTC, LTC, ETH] v3.0.4

# Crypoverse XenForo Addon - Frequently Asked Questions (FAQ)

## Table of Contents

1. [General Questions](#general-questions)
2. [Installation & Setup](#installation--setup)
3. [Features & Functionality](#features--functionality)
4. [Compatibility](#compatibility)
5. [Pricing & Fees](#pricing--fees)
6. [Referral Program](#referral-program)
7. [Technical Questions](#technical-questions)
8. [Troubleshooting](#troubleshooting)
9. [Security & Privacy](#security--privacy)
10. [Support](#support)

---

## General Questions

### What is Crypoverse?
Crypoverse is a cryptocurrency payment gateway that integrates seamlessly with XenForo 2.x, allowing you to accept crypto payments for user upgrades, premium memberships, and any XenForo purchasable content.

### What cryptocurrencies does Crypoverse support?
Crypoverse supports payments across 5 major blockchain networks:
- **Bitcoin (BTC)** - The original cryptocurrency
- **Litecoin (LTC)** - Fast and low-cost transactions
- **Ethereum (ETH)** - Smart contract platform
- **Binance Smart Chain (BSC)** - High performance, low fees
- **Polygon (POL)** - Lightning-fast Layer 2 solution

Plus USDC, USDT, and many other tokens on these networks!

### Why should I choose Crypoverse over traditional payment processors?
- **Zero withdrawal fees** (limited time offer)
- Lower transaction fees than PayPal/Stripe
- Global reach - crypto is borderless
- No chargebacks or payment disputes
- Privacy-friendly for your users
- Instant payment verification
- Earn up to 40% profit share through referrals

### Do I need technical knowledge to use Crypoverse?
No! The addon features a simple 2-step setup process:
1. Get your API key from Crypoverse dashboard
2. Configure the callback URL

Our comprehensive setup guide walks you through everything. No coding required!

---

## Installation & Setup

### How do I install the Crypoverse addon?
1. Upload the addon files to your XenForo installation via FTP or Admin CP
2. Navigate to: Admin CP → Add-ons → Install add-on
3. Follow the 2-step setup guide in the payment profile settings

Full installation instructions are included in the addon.

### What are the system requirements?
- XenForo 2.0.0 or higher (compatible with ALL XenForo 2.x versions)
- PHP 7.2 or higher
- HTTPS enabled (required for secure webhooks)
- cURL extension enabled
- Publicly accessible callback URL (not localhost)

### How long does setup take?
Most merchants complete the entire setup in **5-10 minutes**. The process is:
1. Create Crypoverse account (2 minutes)
2. Create platform and get API key (2 minutes)
3. Install addon and configure (3-5 minutes)
4. Configure callback URL in dashboard (1 minute)

### Do I need a Crypoverse merchant account?
Yes, you need a free merchant account at [www.crypoverse.com](https://www.crypoverse.com/login). The account is free to create and there are no monthly fees.

### What is a callback URL and why is it important?
The callback URL (also called webhook URL) is where Crypoverse sends payment notifications to your XenForo site. This is critical for automatic payment verification. The addon provides this URL after you save your payment profile.

### I use Cloudflare/proxy - will it work?
Yes! Just make sure to whitelist the callback URL to allow webhook access. Full instructions are included in the setup guide.

---

## Features & Functionality

### Can I customize the payment option appearance?
Absolutely! The addon includes a custom styling feature:
- **Background color**: Default #060D1D (dark blue) - fully customizable
- **Text color**: Default #FFD700 (gold) - fully customizable
- **Bold text**: Enabled by default - toggle on/off

No manual CSS editing required - it's all configured in the payment profile settings!

### Does it work with XenForo user upgrades?
Yes! Crypoverse works seamlessly with:
- XenForo user upgrades (subscriptions and one-time purchases)
- XenForo Resource Manager (XFRM) premium resources
- Any other XenForo purchasable add-ons

### How fast are payments processed?
Payments are typically confirmed within **2-10 minutes** depending on:
- Blockchain network selected (Polygon is fastest)
- Network congestion
- Number of confirmations required

Payment status updates automatically in real-time via webhooks.

### Can users pay with any cryptocurrency wallet?
Yes! Users can pay from:
- Hardware wallets (Ledger, Trezor)
- Software wallets (MetaMask, Trust Wallet, Exodus)
- Exchange wallets (Binance, Coinbase, Kraken)
- Mobile wallets

Users simply scan a QR code or copy the payment address.

### What happens if a payment expires?
Payment sessions are valid for a limited time (configured by merchant). If expired:
- User sees clear "Payment Expired" message
- User can initiate a new payment attempt
- No funds are lost (payment wasn't sent)

### Can I offer discounts for crypto payments?
Yes! You can create separate user upgrades with discounted prices specifically for crypto payments, encouraging users to pay with Crypoverse.

---

## Compatibility

### Which XenForo versions are supported?
**ALL XenForo 2.x versions are supported:**
- XenForo 2.0.x
- XenForo 2.1.x
- XenForo 2.2.x
- XenForo 2.3.x

There are absolutely no version limitations!

### What about XenForo 1.x?
The addon is designed for XenForo 2.x only. XenForo 1.x is not supported due to architectural differences.

### Does it work with XenForo Cloud?
The addon requires file system access for installation. Check with XenForo Cloud support regarding custom payment provider addons.

### Will it conflict with other payment providers?
No! Crypoverse works alongside other payment methods like PayPal, Stripe, etc. Users can choose their preferred payment method at checkout.

### Does it work with [specific addon name]?
If the addon uses XenForo's standard purchasable system, then yes! Crypoverse integrates with XenForo's core payment system and works with any properly-coded purchasable addon.

---

## Pricing & Fees

### How much does Crypoverse cost?
**FREE to install and use!**
- No monthly subscription fees
- No setup fees
- **Zero withdrawal fees** (limited time offer for new merchants)
- Only pay small transaction processing fees

### What are the transaction fees?
Transaction fees vary by:
- Blockchain network selected (each network has different costs)
- Current network congestion
- Transaction size

All fees are displayed transparently before payment. Fees are among the lowest in the industry!

### Who pays the transaction fees - merchant or customer?
**You decide!** Crypoverse lets you configure:
- **Merchant pays fees**: Provide premium experience (fees deducted from payment)
- **Customer pays fees**: Standard processing (fees added to payment amount)
- **Hybrid**: Different settings for different payment types

### Are there any withdrawal fees?
**Currently NO!** As a limited-time offer for new merchants, Crypoverse charges **zero withdrawal fees**. You keep 100% of your earnings when withdrawing to your wallet.

### Is there a minimum withdrawal amount?
Check the Crypoverse merchant dashboard for current minimum withdrawal amounts. These vary by cryptocurrency and network.

### How do I get paid?
1. Customers pay via Crypoverse
2. Funds appear in your Crypoverse merchant balance
3. Withdraw to your personal crypto wallet anytime
4. Or convert to fiat currency via partner exchanges

---

## Referral Program

### How does the referral program work?
For every merchant you refer to Crypoverse using your unique referral code, you receive a share of the profit Crypoverse generates from their activity.

### How much can I earn through referrals?
**Up to 40% profit share per referral!**
- The more you refer, the more you earn
- Unlimited referrals accepted
- Lifetime recurring earnings
- No caps, no limits

### Is there a limit to how many people I can refer?
**No limits whatsoever!** Refer as many merchants as you want and earn from all of them.

### How do I get my referral code?
Log in to your [Crypoverse merchant dashboard](https://www.crypoverse.com/merchant) and navigate to the referral program section. Your unique referral code and tracking links are provided there.

### When do I get paid for referrals?
Referral earnings are calculated based on the profit Crypoverse generates from your referrals' activity. Payment schedules and thresholds are detailed in your merchant dashboard.

### Can I refer my own clients/customers?
Absolutely! This is perfect for:
- Web developers building sites for clients
- Forum administrators in the same niche
- Business partners and colleagues
- Anyone running a XenForo community

---

## Technical Questions

### How are webhooks secured?
Crypoverse uses multiple security layers:
- Timestamp validation (30-day window)
- Replay attack prevention
- Signature verification
- HTTPS-only transmission
- API key authentication

### What data is sent to Crypoverse?
The addon sends:
- Payment amount and currency
- Customer user ID (for reconciliation)
- Product name/description
- Platform information (XenForo version)
- Metadata for support purposes

No sensitive personal data like passwords or emails are sent.

### Where are transactions stored?
- Transaction data is stored in your XenForo database
- Full transaction details available in Admin CP
- Backup transaction data stored on Crypoverse servers
- You can export transaction history anytime

### Can I test payments before going live?
Yes! We recommend:
1. Create a small-value test user upgrade ($0.50-$1.00)
2. Make a real payment using a small amount
3. Verify the payment completes successfully
4. Check XenForo processes the upgrade correctly

There's no separate sandbox/test mode - use real small-value transactions.

### What happens if my site goes offline during a payment?
- Payment is still processed on the blockchain
- Webhook is retried multiple times by Crypoverse
- Once your site is back online, the webhook is delivered
- If webhook fails completely, check Merchant Dashboard for pending payments

### How do I update the addon?
1. Download the latest version from [crypoverse.com/plugin](https://www.crypoverse.com/plugin)
2. Upload the new files via FTP or Admin CP
3. Navigate to Admin CP → Add-ons → Upgrade add-on
4. Follow any upgrade instructions provided

Your settings and payment profiles are preserved during updates.

---

## Troubleshooting

### Payment is stuck on "Pending" status
**Common causes:**
1. Blockchain confirmation delay (wait 5-10 minutes)
2. Webhook not reaching your server (check firewall/proxy)
3. Callback URL not configured correctly

**Solutions:**
- Wait for blockchain confirmations to complete
- Verify callback URL is whitelisted in Cloudflare/proxy
- Check Crypoverse merchant dashboard for payment status
- Contact support if issue persists

### Error: "Unable to initiate payment"
**Common causes:**
1. API key incorrect or expired
2. Network connectivity issues
3. Crypoverse API temporarily down

**Solutions:**
- Verify API key in payment profile settings
- Check your server can connect to api.crypoverse.com
- Try again in 2-3 minutes (may be temporary)
- Check error details displayed below error message
- Contact [email protected] with error details

### Error: "Authentication failed"
**This means:**
Your API key is invalid, expired, or not active.

**Solutions:**
1. Log in to [Crypoverse merchant dashboard](https://www.crypoverse.com/merchant)
2. Verify your platform is active
3. Regenerate API key if needed
4. Update API key in XenForo payment profile
5. Contact support if problem persists

### Webhook URL not working with Cloudflare
**Solution:**
1. Log in to Cloudflare dashboard
2. Navigate to Security → WAF → Tools
3. Add your callback URL to the allowlist
4. Or: Create firewall rule to allow Crypoverse webhook IPs
5. Full instructions in the addon setup guide

### Custom colors not showing
**Common causes:**
1. Browser cache
2. Another style/addon overriding CSS

**Solutions:**
- Clear browser cache and hard refresh (Ctrl+F5)
- Check payment profile settings are saved
- Verify "Bold text" option is enabled
- Try in incognito/private browsing mode
- Contact support if issue persists

### User completed payment but upgrade not applied
**Solutions:**
1. Check Admin CP → Payment Profiles → Logs for webhook delivery
2. Verify purchase request was created in Admin CP → Users → Purchase requests
3. Check if payment status is "completed" in Crypoverse dashboard
4. Manually complete the purchase request if needed
5. Contact support with transaction ID

---

## Security & Privacy

### Is Crypoverse secure?
Yes! Security features include:
- HTTPS-only communication
- API key authentication
- Webhook signature verification
- Timestamp validation (prevents replay attacks)
- Regular security audits
- Enterprise-grade infrastructure

### What about user privacy?
Cryptocurrency payments are privacy-friendly:
- No credit card information required
- No personal banking details stored
- Users only need a crypto wallet
- Blockchain provides transparency without exposing identity

### Can payments be reversed or charged back?
**No!** This is actually a benefit:
- Cryptocurrency transactions are irreversible
- No chargeback fraud
- No payment disputes
- Merchants keep 100% of legitimate payments

However, merchants should still honor refund requests through customer service.

### Is my API key stored securely?
Yes! Your API key is:
- Stored in XenForo's encrypted database
- Never exposed in frontend code
- Only used for server-to-server API calls
- Protected by XenForo's security layers

Keep your API key confidential - never share it publicly!

### What happens to user payment data?
- Payment addresses are generated for each transaction
- Transaction IDs stored for reconciliation
- Full blockchain transparency
- No credit card/banking data stored
- GDPR compliant

---

## Support

### How do I get help?
** FASTEST SUPPORT - Response within 1 hour:**
**Email**: [email protected]

**Other Support Channels:**
- **Live Chat**: [crypoverse.com/contact](https://www.crypoverse.com/contact)
- **Documentation**: [crypoverse.com/documentation](https://www.crypoverse.com/documentation)
- **Plugin Updates**: [crypoverse.com/plugin](https://www.crypoverse.com/plugin)

### What information should I provide when requesting support?
For fastest resolution, include:
1. Your forum URL
2. XenForo version
3. Addon version
4. Error message (if any) with full technical details
5. Transaction ID (if payment-related issue)
6. Steps to reproduce the issue
7. Screenshots (if applicable)

### Do you offer installation service?
Contact [email protected] to inquire about installation services. In most cases, the installation is simple enough to do yourself following the included guide.

### Can you customize the addon for my needs?
For custom development requests, contact [email protected]. Basic customizations may be available for an additional fee.

### Where can I report bugs?
Email [email protected] with:
- Detailed description of the bug
- Steps to reproduce
- Error messages or logs
- Your environment (XenForo version, PHP version, etc.)

We take bug reports seriously and typically release fixes within 24-48 hours.

### How often is the addon updated?
- Security updates: Immediately as needed
- Bug fixes: Within 24-48 hours of confirmed reports
- Feature updates: Regular releases based on user feedback
- Compatibility updates: As new XenForo versions are released

Check [crypoverse.com/plugin](https://www.crypoverse.com/plugin) for latest version.

### Is there a community forum?
Currently, support is provided directly through email and live chat. A community forum may be launched in the future based on user demand.

### What are your support hours?
- **Email support**: 24/7 with response within 1 hour
- **Live chat**: Check website for current availability
- **Emergency support**: Available for critical payment issues

---

## Additional Questions

### Can I use Crypoverse on multiple sites?
Yes! Each site requires:
- Its own payment profile in XenForo
- Its own platform created in Crypoverse dashboard
- Separate API key for each site

This allows you to track revenue per site separately.

### Does it support recurring subscriptions?
Yes! Crypoverse supports:
- One-time payments (single purchases)
- Recurring subscriptions (monthly, yearly, etc.)

Users are reminded before each renewal and can cancel anytime.

### What happens if cryptocurrency prices change during payment?
Payment amounts are locked when the transaction is initiated:
1. USD amount is converted to crypto at current rate
2. User has limited time to complete payment (e.g., 30 minutes)
3. Exact crypto amount is displayed
4. Price doesn't change during this window

### Can I accept donations or tips?
While the addon is designed for XenForo purchasables, you could create:
- User upgrade tiers for different donation amounts
- Resource purchases with donation-level pricing
- Any purchasable item representing a donation

### Will my users need to create Crypoverse accounts?
**No!** Users don't need Crypoverse accounts. They simply:
1. Select Crypoverse at checkout
2. Click "Pay with Cryptocurrency"
3. Send payment from their existing wallet
4. Done!

Only merchants need Crypoverse accounts.

### How do refunds work?
Cryptocurrency transactions are irreversible, so traditional "refunds" aren't possible. Instead:
1. Contact the customer to get their crypto wallet address
2. Manually send cryptocurrency back to their wallet
3. Mark the purchase as refunded in XenForo
4. Remove their user upgrade manually

Or set up a refund policy upfront explaining crypto payment finality.

### Can I accept crypto AND traditional payments?
Absolutely! Crypoverse works alongside:
- PayPal
- Stripe
- Bank transfer
- Any other XenForo payment provider

Users choose their preferred payment method at checkout.

---

## Still Have Questions?

If your question isn't answered here:

**Email**: [email protected] (Response within 1 hour) FASTEST
**Live Chat**: [crypoverse.com/contact](https://www.crypoverse.com/contact)
**Documentation**: [crypoverse.com/documentation](https://www.crypoverse.com/documentation)

We're here to help! Don't hesitate to reach out.

---

**Last Updated**: January 2025
**Version**: 3.0.0
**© 2025 Crypoverse. All rights reserved.**