NATS4 CCBill

From TMM Wiki
Jump to navigationJump to search
NATS 4
Members Admin
The Members Admin
View Member Details
Add Member
MySQL Auth
Mod Authn DB
Multisite Access
Member Logging
Member Password Retrieval
OpenID Connect
Mod Auth OpenIDC
ID Numbers
    Biller Instructions
NATS4 Biller List
2000Charge
2000Charge Gateway
2KCHARGE
A1Payments
Aebill
Aconti
Allopass
AltoBilling
Argus
Authorize.net
Bill1st Gateway
BillAPay Gateway
Billing Revolution
Billing United
Bit-Pay
BoaCompra
Braintree Payments
C2Bill
CardFlex
CCBill
CCBill Flexform
CCBill Web900
CashSend
CashtoCode
Centili
Centrobill
Clearcard
Clearcard IDV
Click and Buy
CoinGate
CoinPayments
CommerceGate
CurePay
DHD
DHDGateway
DIMOCO
EGatePay
ElectraCash
eMerchantPay Gateway
eMPPay.com
Epoch
Escalion
EuroBill
EPGBill.com
Ezic, Inc.
Focal Payments
FXBilling
FXBilling Native
Gateway tokens
Gigadat
Global Access
GlobalCharge
Global DPS
GoCoin
Greta 11 (G11Bill)
GTBill
GTBill GATEWAY
GXBill
ICN Ltd.
Itelebill
Jettis International
Jettis International Gateway
LocalBilling
MobiusPay
MerlinBill
NETbilling
NETbilling Native
NetCash
NetMobile
Netpay International
NoCreditCard
OrbitalPay
Password By Phone
Pay4
Pay900
Payment Network
Paygarden
Paygea
PayPal
Paysite Cash
Payspace
Payspace Gateway
Plug'n Pay
Prime Orange
Probiller
PumaPay
Rocketfuel
RocketGate
RocketGate Native
RSBilling
RSBilling Native
SafeCharge
SafeCharge Native
Secure Billing Worldwide
Secure Billing Worldwide Gateway
Secure Trading
SecurionPay
SegPay
SegPay Gateway
SOFORTdauerauftrag
Sonic Bill
StandardBill
TrustCharge
Telecom
UKash
Vendo Services
Vendo
Verotel Pro
Voxtel
VXSBill
WebBilling
Wispay
WTS
WTSeu
Zombaio
Shopping Cart Sales
Switching From Epoch to Epoch EU

Please don't test your biller setup with NATS4 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%%


As of Nats version 4.0.68.3 and above, please use the following in the Denial URL and Approval URL fields:

  • http://linkdomain/signup/returnurl_ccbill.php?memberid=%%memberid%%&session=%%natssess%%
  • http://linkdomain/signup/returnurl_ccbill.php?status=approved&memberid=%%memberid%%&session=%%natssess%%


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 you 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

Enter the option you want to sell with NATS in the CCBill's Pricing Admin. Record each option's SKU I.D. number.

Set up Datalink

You need one or more sub-accounts to setup Datalink -- 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

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

Go to Sites Admin, create or edit a tour, 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.

Go to the Join Options section. The options starting with CCB900 or CCBill Web900 apply to [[CCBill Web900]. Fill in your sub-account, form, and SKU I.D. information. See the next section for CCBill upgrade information.

Subscription Upgrade

Use CCBill's back-end post system by setting up an upgrade sub-account for each site in CCBill's admin. Then go to Sites Admin, edit a tour, and create or edit a join option. Go 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.

Contact CCBill and inform them that you want to enable upgrades using the back-end posts. You must give CCBill your server's IP addresses 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.

on your CCBill account, 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 need to 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 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 MySQL Auth, then you can turn password management off.

Instead of letting CCBill write to the NATS database, have CCBill 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 5 seconds, but you can changed this to 3 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 (mod_auth_mysql or some other method 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 or tech 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 or tech and CCBill to fix the password file issue -- even if members get access through NATS.

See Also