Set up on CCBill's Website

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:

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.

Please ensure that "Traffic Manager" feature of CCBill is not turned on. This feature cascades surfers between different payment types within CCBill's system and can cause NATS cascading to not work properly.

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 least 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.

NOTE: Make sure that your Datalink account is setup to be for 'All sub accounts'

Set up CCBill in NATS

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.

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:

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'sjoin 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.

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.