CCBill

NATS 3 About NATS 3 NATS3 Requirements IPSP Integration NATS3 Changelog For Affiliates Affiliate Link Codes Affiliate Adtools Affiliate Rewards Affiliate Referral Stats Automatic Campaigns Affiliate Billing Info Deep Linking Affiliate Defaults Linkcode ASP Query String NATS3 Main Program Page TubeStudio Adtools Setup Apache Configuration MySQL Settings Creating Admin Accounts File Upload Setup Link Domain NATS3 Files and Directories NATS Go Live Checklist Moving NATS3 Admin Overview Troubleshoot Chart Director Fix Admin Overview Graphs Admin Reports Profit & Loss Report Strack Surfer Stats Chargeback and Credit Amount Inaccuracies Payments Admin Payment Dump Setting Up Pay Vias Hidden Payout Options Temporary Payout Payment Option Webmasterchecks Affiliate Payout Domestic Wire Instant Payments Intercash International Wire Moneybookers RevUpCard NATS Payments PayPal Payment Dump Entry Numbers Payment Dump Variables Payout Scales Epassporte Affiliates Admin Override ID Numbers Account Representatives Affiliate Starting Balance Affiliate Documents Affiliate Start Page Affiliate Referrals Manual Sale Manual Invoice Statistic Query Strings Creating Admin Accounts Affiliate-Specific Join Options Disabled and Banned Affiliates Verifying Account Changes Members Admin MySQL Auth Members Admin Member ID Numbers Expired Members Creating Trial Members Member Delete Member Logging Trial Member Sites Admin Sites Site Setup Configure Redirects ID Numbers Automail Site User Management Username Checking Join Form Errors Free Pre-Initial Checkbox Payouts Based on Program and Join Options Payouts Based on Join Option and Per Option Adding Extra Site Tours Site Partner Join Options Multisite Access Removing Join Options Tour Setup Site Undelete Join Option Box vs Button Redirecting Traffic to a Sponsor Qualified Join Page Hits Type-In Traffic Allowed languages Linkcode Decoding Programs Admin Programs Admin NATS Program Adding Programs ID Numbers Paid Trials Main Program Page Pay Per Click Pay Per Sale Revenue Share Program Default Payouts Referral Payout Tier Third Parties Admin Third Parties Chargeback and Credit Amount Inaccuracies AdultFriendFinder AdultFriendFinderAPI   AdultFriendFinder versus AdultFriendFinderAPI AllMightyContent CamSpot Cams DatingGold EffexMedia Gamelink Jettis International Third-Party Mallcom My Dirty Hobby SexGoesMobile (SGM) Streamate   Streamate Biller versus Third-Party VideoSecrets WebCamClub   WebCamClub with Biller WebCams XonDemand Adtools Admin Adding Adtools Linking to Join and Tour Pages Duplicate Site Adtools Banner Hot-Linking Adding RSS Feeds to NATS's Adtools Downloadable Adtool Bulk Importer Dump Hosted Galleries Hosted Adtool NATS Thumbnails TubeStudio Adtools Admin Billers Admin Biller Cascade NATS Cascades Adding Cascades Biller Cancel Promotions Cascade Weight Autocascade Hidden Cascades Geo-Targeting Cascades Type-In Cascade Post-Biller Templates Extra Biller Fields HTTPS Gateways Payment Deduction Timed Cascade Rules Multiple Biller Accounts Upgrade Plus Adding a Biller   Biller Instructions NATS3 Biller List 123Bill 365Billing 2000Charge Aconti Payment Service Allopass Ampay Argus Authorize.net Bill1st Gateway Billing Line BoaCompra Card Gate Plus CCBill CCBill Direct Pay CCBill Web900 Centrobill ChargeMeLater ClearCard ClearCard IDV Commerce Gate CurePay DHD Media E-Pay Company Edelweiss Card EGatePay ElectraCash EMerchantPay (Interconsult) EnterCharge Epoch EProcessingNetwork EuroBill EPGBill.com FABILLING Global Access GTBill GXBill HeidelPay HeidelPay Gateway iBill ICN Ltd. Infinity Payment Interconsult Jettis Jettis Gateway Jettis International Linkpoint LocalBilling Merchant Partners Gateway Merchant Partners Membership Merchant Solutions MyVirtualCard Netbilling Netbilling Native NetCash Netpay International NoCreditCard Oakbill Optimized Payment System Password by Phone Pay4 Paygea Payment Network Paysite Cash PhoneAccess Plug'n Pay PPPCard Probiller Protx Pure Vanilla RocketGate RocketGate Native RSBilling SafeCharge Secure Billing World SegPay Sonic Bill StandardBill Streamate Symmetrex TrustCash TrustCharge txtNation Ukash Universal Processing Verotel Pro VXSBill WebBilling WebPay WTS WTSeu YNOT Processing Zombaio Netbilling v3 Upgrade Instructions Purchasing Tokens Through Netbilling Streamate Biller versus Third-Party Switching From Epoch to Epoch EU Epoch Member Approval Plus Multiple Biller Accounts Popups Admin Popup Chain Price Cascade Rewards Admin Rewards Admin Reward Points Unshipping Rewards Cross-Sells Admin Cross Sells Admin Process Gateway Cross Sales Outside NATS Outgoing Gateway Cross Sales CCBill Cross-Selling Cross Sells: A to Z Mailing Admin NATS3 Mailing Admin Email Expired Members Repeating Email Member Cancel Emails Member Chargeback Emails Member Credit Emails Member Join Emails Member Rebill Emails Mailer Template Variables Skins & Templates Admin Smarty Plugins Skins Editing Skins Creating Skins Switching Skins Templates nats_code Affiliate Stats Template Affiliate Support Template Affiliate Login Template custom errors.php Template Array Variable Detailed Stats NATS Variables Dialer Statistics Affiliate Signup Post URL Variables Member Usernames & Passwords Output An Affiliate's Last Paid Date Custom Program and Campaign Selection Pages CAPTCHA Removal Username Recommendations Password Retrieval Post-Biller Templates Geo-Target Join Options Template Caching Random Usernames and Passwords Base Templates Protecting Template Data Mail Reseller Signup Template Variable Names Smarty Smarty print array News Section Templating Affiliate Signup Email Getting The NATSCode Checking for Usernames on All Sites Adding Stats to Affiliate Pages Affiliate Join Page Linkcodes   Template Functions nats_apache_note nats_convert_bytes nats_decode nats_encode nats_fhg nats_helper_row_fill nats_get_gateway_token nats_list_campaigns nats_list_programs nats_list_sites nats_my_decode_entities nats_my_encode_entities nats_smarty_function_ajax_box nats_smarty_function_amount_owed nats_smarty_function_gateway_xsell nats_smarty_function_getbonus nats_smarty_function_get_paid_date nats_smarty_rebuild_link nats_smarty_rebuild_query nats_smarty_function_reseller_ajax_box nats_tooltip nats_tour_report nats_wmref_list Template Shortcuts ajax_box amount_owed apache_note convert_bytes fhg gateway_xsell get_loginid_from_campaignid get_gateway_token get_paid_date list_campaigns list_programs list_sites new_gateway_xsell rebuild_link rebuild_query reseller_ajax_box reward_points tooltip tour_report wmref_list Common Parameters assign assign_prefix count data_only display_on_assign start tpl   Helper Functions nats_code nats_extract_program nats_extract_site nats_modify_program nats_modify_site Configuration Admin NATS3 Configuration Options Extra Country Options PayVia Minimum Log Admin Activity IP Address Filtering MEMBER EXPIRE PAD Second Sign-up Matching Affiliate Signup Email GeoIP Fake Upgrade Misc. Admins Database Cleanup Troubleshooting Common Errors Email_Issues Auto Login Emptying Forms AutoLogin Cookie CAPTCHA Changing Licenses Expired License Zend License NATS Extras Remote Affiliate Authentication Shopping Cart Sales Moving Tours, Members' Area, and Galleries Require W-9 Admin Areas Fraud Report NATS Content of the Day Module NATS Load Balancing Module Gallery Builder Module Build Your Own Anything Module NATS Code Wordpress Plugin Error_message_display TMMid

Please don't test your biller setup with CCBill's test account—it won't work correctly.

Set up on CCBill's Website

Register a CCBill account.

To setup the site sub-account, login to the CCBill Admin, click Tools, click Account Maintenance, and go to the Account Setup section. Follow the on-screen instructions to setup the the site basics. You don't need to download the index page.

After setting up a sub-account, click Tools and Account Maintenance again and select a site from the list of sub-accounts. Choose Basic Setup and enter the following Denial URL:

• http://linkdomain/signup/signup.php?step=3&site=%%siteid%%&memberid=%%memberid%%

Choose Advanced Setup and enter the following URL in both the Denial and Approval Post URL fields:

• http://linkdomain/signup/process_ccbill.php

In the above Denial and Approval URLs, replace linkdomain with your linkdomain.

Go to User Management. If your site needs user management, set the following options, but make sure they match the NATS settings.

• Username Type: USER DEFINED
• Collect Username/Password: Display Username and Password
• Min. Username Length: 6
• Max. Username Length: 16
• Min. Password Length: 6
• Max. Password Length: 16

Ensure CCBill's Pricing Admin lists every pricing option you want to set up for this site in the NATS.

Set up Datalink

You need at two or more sub-accounts to set up Datalink -- but you don't need to use the second account. Before you start setting up Datalink, you also need your NATS server's IP address.

Contact CCBill customer support and ask them to setup Datalink or login to the CCBill Admin, go to Premium Features, go to Value Added Features, go to Data Link Services Suite, and enter a username and password. Give CCBill customer support your NATS IP address or enter it on the Data Link Services Suite page.

Set up CCBill in NATS

Go to the Billers Admin, select CCBill from the Billers drop-down, and click Add. Enter your CCBill account number, login, password, datalink username, and datalink password.

In NATS3, go to Sites Admin, edit or create a site, and go to the Biller Details section. In the CCBill subsection and enter your Sub-Account ID. You may optionally enter any of the following: the CC Form ID, Check Form ID, Web900 Form, Upgrade sub-account number, and SKU ID.

In NATS4, go to Sites Admin, edit a tour, and go to the Biller Details section. In the CCBill subsection, enter your Sub-Account ID. You may optionally enter any of the following: the CC Form ID, Check Form ID, Web900 Form, Upgrade sub-account number, and SKU ID.

In either version of NATS, go to the Join Options section and enter your CCBill Payment ID (Subscription Type ID), your credit card code (CC), check code, and Web900 code. You may also enter your CCBIll alternative sub-account join option.

Subscription Upgrade

Use CCBill's back-end post system. Set up an upgrade sub-account for each site in CCBill, find a site in the NATS Sites Admin, and click the Edit icon. Scroll down to the Biller Details section and find the CCBill subsection. Enter the upgrade sub-account information in the provided field and click the Save Changes button. Repeat for each site. The next step is to contact CCBill and inform them that you want to enable upgrades using the back-end posts.

When setting up your upgrade sub-accounts, you must provide CCBill with the IP addresses of your server for both the normal and upgrade sub-accounts. The IP addresses for the normal and upgrade sub-accounts must match or the upgrades will not work.

Go to advanced setup for the upgrade sub-account and enter the following URL in the Denial and Approval Post URL fields:

• http://<linkdomain>/signup/process_ccbill_upgrade.php

Replace <linkdomain> with your site's linkdomain.

After CCBill upgrades are working, put the following link in your limited members area for user upgrades:

• http://<linkdomain>/signup/upgradeplus.php?site=<siteid>&username=<username>

Replace <linkdomain> with the linkdomain for your site. Replace <siteid> with your site's ID number. Replace <username> with the upgrading member's username.

CCBill Random Usernames and Passwords

If you setup random username's on CCBill's website, you must remove the Username and Password fields from your site's join form.

Disable CCBill Decline Auto-Redirect

If CCBill automatically redirects to a "Signup with Bank Account" page regardless of what's in your cascade, you probably have CCBill Decline Auto-Redirect enabled. Go to the CCBill website, log in, find the Forms or Traffic Flow page, and disable the feature to automatically redirect surfers on a decline.

Invalid Request Error

The invalid request error appears when the biller isn't set up correctly in the Billers Admin. Go to the Billers Admin and double-check your biller account info. Remember not to include the sub-account ID in the account ID. If this is not the problem, ensure the sub-account was been enabled.

CCBill Member and Password Management

You need to enable CCBill password management if you use text password files. If you use NATS for authentication with mod_auth_mysql or a similar system that checks logins using the NATS members database table, then you can turn password management off.

Instead of letting CCBill write to the NATS database, have CCBill add and remove members in your own members database. Manage the database with scripts called from NATS postbacks.

If you have old sites that used flat password files and now use NATS, then you must keep the password management on and add the following line to your .htaccess file:

AuthMySQLAuthoritative Off

Notes

Three settings in the CCBill Administration Interface affect cascading billing.

If a check signup form exists, denied transactions are sent there. To cascade, modify the traffic flow here in the CCBill Admin. Go to Tools, Account Maintenance, Account Admin, Form Admin, Choose Form, Traffic, and set the Traffic Flow to None. Now CCBill sends denied transactions to the denial URL immediately.

CCBill automatically redirects denied CC transactions. By default, the redirect takes five seconds, but you can changed this to three seconds. Go to Tools, Account Maintenance, Account Admin, Basic, Denial Redirect Time. Note: activating the None option disables the automatic redirect.

By default, on a soft decline, CCBill lets the customer submit their purchase three times before sending them to the denial URL. CCBill can be send customers to the denial URL after the first decline; ask them to disable the soft decline retries on your account.

Common Datalink Errors

Note: these failure codes may change:

• Error: Authentication Failed 693 Cause: Three or more failed logins within the last hour.

• Error: Authentication failed. 708 Cause: Invalid user name, incorrect user name, no user name provided, invalid password, incorrect password, no password provided, incorrect clientAccnum/clientSubacc, or user is setup for a different clientAccnum/clientSubacc than provided

• Error: Authentication failed. 722/723 Cause: Incorrect IP address.

CCBill Adding Users Error E-Mail

If you use NATS to handle your password management (MySQL Auth using the NATS members table) then you can safely disregard this mail.

If you use standard flat password files, then you should talk to your host and CCBill to resolve this issue with them. NATS does not handle flat password files and we can not fix the problem.

If you use both NATS and flat password files, then you should still talk to your host and CCBill to fix the password file issue -- even if members get access through NATS.

See Also

• CCBill Cross-Selling -- CCBill Cross Sells