Payment Providers

Overview

The Payment Providers Management page is the central hub for configuring and managing all payment processor integrations in ComusThumbz. This comprehensive interface supports 35+ payment processors worldwide, with specialized configurations for adult content merchants including CCBill, Epoch, SegPay, Verotel, and many regional processors.

Key capabilities include:

• Enable/disable payment providers
• Configure processor credentials (API keys, merchant IDs, secrets)
• Switch between sandbox and production modes
• View transaction statistics per provider
• Access setup guides for each processor
• Compare processor features (fees, regions, adult-friendliness)

System Requirements

PHP Requirements

PHP Extensions Required

• mysqli - Database connectivity
• openssl - SSL/TLS for API communications
• curl - API requests to payment processors
• json - JSON encoding/decoding for configurations

Database Requirements

• MySQL 5.7+ / MariaDB 10.3+
• InnoDB engine for transaction tables

Features & UI Elements

Page Header

[Screenshot: payment-providers-header]

The page header displays:

• Title: "Payment Providers"
• Breadcrumb: Dashboard / Payment Providers

Alert Messages

Success and error messages appear below the header:

• Success (green): "Payment provider updated successfully!"
• Error (red): "Invalid security token. Please try again." or database errors

Providers Table

[Screenshot: payment-providers-table]

The main table displays all configured payment providers with columns:

Statistics Grid (Per Provider)

Each provider row shows transaction statistics:

• Total: Total transactions processed
• Purchases: Initial purchases (typeid = 1)
• Rebills: Recurring charges (typeid = 3)
• Open: Active/pending transactions (statusid = 1)

Action Buttons

Quick Actions Section

Below the providers table:

• Manage Access Packages → accesspackages.admin.php
• View Transactions → billingtransactions.admin.php
• View Logs → billinglogs.admin.php

Processor Comparison Chart

[Screenshot: payment-providers-comparison]

A comprehensive comparison table showing 35 payment processors with:

Regional Recommendations

The page includes quick recommendations by region:

• USA: CCBill, Epoch, SegPay, Square, Authorize.Net, Clover
• Europe: Verotel, Zombaio, Klarna, Adyen
• Russia/CIS: Robokassa
• China: UnionPay (Alipay/WeChat ban adult)
• Korea: Toss Pay (KakaoPay/Naver ban adult)
• Japan: LINE Pay (PayPay strict policies)
• India: Razorpay, Paytm
• Southeast Asia: 2C2P, MOLPay
• High-Risk/Adult: CCBill, Epoch, SegPay, Verotel, Adyen, Paxum, Centrobill
• Cryptocurrency: CoinPayments, Centrobill, Paxum

Provider Configuration Modal

[Screenshot: payment-providers-configure-modal]

When clicking "Configure" on a provider, a modal opens with processor-specific fields.

Common Fields (All Providers)

Postback/Webhook Settings (All Providers)

Advanced Options

Processor-Specific Configurations

CCBill / CCBill Dynamic

PayPal

SegPay

Epoch

Verotel

CoinPayments

Regional Processors

The page includes configurations for regional processors:

• Robokassa (Russia): Merchant Login, Password #1, Password #2
• 2C2P (Southeast Asia): Merchant ID, Secret Key
• Razorpay (India): Key ID, Key Secret
• MOLPay (Malaysia): Merchant ID, Verify Key
• Toss Pay (Korea): Client Key, Secret Key
• LINE Pay (Japan/Taiwan): Channel ID, Channel Secret

Processors with Adult Content Warnings

• Alipay - NO ADULT CONTENT
• WeChat Pay - NO ADULT CONTENT
• KakaoPay - NO ADULT CONTENT
• Naver Pay - Strict adult content policies
• PayPay - Strict content policies

• Adyen - Enterprise-grade, accepts with approval
• CCBill - Industry leader for adult content
• Epoch - Global gateway for adult content
• SegPay - High-risk specialist
• Verotel - 25+ years in adult billing

Step-by-Step Usage

Enabling a Payment Provider

1. Navigate to Admin Panel → Billing → Payment Providers
2. Locate the provider in the table
3. Click Configure button
4. Check Enable Provider checkbox
5. Fill in required credentials (marked with *)
6. Choose Sandbox Mode for testing
7. Click Save Configuration

Configuring CCBill (Example)

1. Log into your CCBill Admin panel
2. Navigate to Sub Account Admin → Advanced
3. Copy your Salt/Encryption Key
4. In ComusThumbz admin, click Configure on CCBill
5. Enter your 6-digit Account Number
6. Enter your 4-digit Sub Account Number
7. Paste the Salt / Encryption Key
8. Configure the Postback URL in CCBill pointing to your site
9. Click Save Configuration
10. Test with a sandbox transaction before enabling production

Testing Postback URLs

1. Configure the provider with sandbox credentials
2. Enable Sandbox Mode
3. Complete a test transaction
4. Check Billing Logs for postback receipt
5. Verify user access was granted correctly
6. Disable Sandbox Mode for production

Viewing Setup Guides

1. Click Setup Guide button next to any provider
2. A modal opens with detailed integration instructions
3. Follow the provider-specific steps
4. Use the recommendations to configure correctly

Troubleshooting

Common Issues

"Invalid security token" Error

Cause: CSRF token expired or mismatch

Solutions:

1. Refresh the page and try again
2. Clear browser cookies and log in again
3. Check session timeout settings

Provider Not Appearing

Cause: Database not seeded with providers

Solutions:

1. Run the INSERT statement from Installation Requirements
2. Check database connection in config.inc.php
3. Verify tblPaymentProviders table exists

Postback Not Received

Cause: Incorrect postback URL or blocked by firewall

Solutions:

1. Verify postback URL is publicly accessible
2. Check server firewall allows incoming POST requests
3. Review provider's IP whitelist requirements
4. Check SSL certificate is valid

Sandbox Mode Not Working

Cause: Provider credentials are for production

Solutions:

1. Obtain separate sandbox/test credentials from provider
2. Use provider's test card numbers
3. Verify sandbox endpoint URLs

Provider-Specific Issues

CCBill Signature Validation Failed

Cause: Incorrect salt/encryption key

Solutions:

1. Re-copy the key from CCBill Admin → Sub Account Admin → Advanced
2. Ensure no extra spaces in the key
3. Verify form digest settings in CCBill

PayPal "Restricted Account"

Cause: Adult content detected

Solutions:

1. Contact PayPal support for high-risk approval
2. Consider alternative processors (CCBill, Epoch)
3. Use cryptocurrency options (CoinPayments)

Translatable Strings

{
    "paymentproviderstitle": "Payment Providers",
    "paymentprovidersbreadcrumb": "Dashboard / Payment Providers",
    "paymentprovidersconfigured": "Configured Payment Providers",
    "paymentproviderscomparison": "Payment Processor Comparison",
    "paymentprovidersconfigure": "Configure",
    "paymentproviderssetupguide": "Setup Guide",
    "paymentproviderssave": "Save Configuration",
    "paymentproviderscancel": "Cancel",
    "paymentprovidersenabled": "Enabled",
    "paymentprovidersdisabled": "Disabled",
    "paymentproviderssandbox": "Sandbox",
    "paymentprovidersproduction": "Production",
    "paymentprovidersenableprovider": "Enable Provider",
    "paymentproviderssandboxmode": "Sandbox Mode",
    "paymentprovidersaccountsettings": "Account Settings",
    "paymentproviderspostbacksettings": "Postback/Webhook Settings",
    "paymentprovidersadvancedoptions": "Advanced Options",
    "paymentproviderstotal": "Total",
    "paymentproviderspurchases": "Purchases",
    "paymentprovidersrebills": "Rebills",
    "paymentprovidersopen": "Open",
    "paymentproviderssuccess": "Payment provider updated successfully!",
    "paymentproviderserrorcsrf": "Invalid security token. Please try again.",
    "paymentproviderserrorupdate": "Failed to update provider",
    "paymentprovidersrecommendations": "Quick Recommendations by Region",
    "paymentprovidersmanagepackages": "Manage Access Packages",
    "paymentprovidersviewtransactions": "View Transactions",
    "paymentprovidersviewlogs": "View Logs",
    "paymentprovidersadultfocus": "Adult Focus",
    "paymentprovidersfees": "Fees",
    "paymentprovidersspeed": "Speed",
    "paymentprovidersrecurring": "Recurring",
    "paymentproviderscrypto": "Crypto",
    "paymentprovidersspecialfeature": "Special Feature",
    "paymentprovidersnoadult": "NO ADULT CONTENT",
    "paymentprovidershighriskok": "HIGH-RISK OK"
}

Related Documentation

• Access Packages - Subscription package management
• Billing Transactions - Transaction history
• Billing Logs - Postback and webhook logs
• User Subscriptions - User subscription management

Version History