NETbilling
Article Topics: Billers, Cross Sales, Up Sales
Please Note: Please don't test your biller setup with NATS NETbilling's test account—it won't work correctly.
These instructions describe using NETbilling as a gateway. If you want to use NETbilling as a regular biller, please see the NETbilling Native article.
Set up on NETbilling's Website
Register an account on NETbilling's website.
To process transactions, in the NETbilling administration panel under "Account Setup" -> "Account Management" -> "Access Security", check the box next to "Enable Native Direct Mode v.3 (SAS) Channel" and enter your server's IP address in the box labeled "Specify Trusted Static IP Addresses allowed to originate Direct Mode transactions". Transactions will not process through NETbilling if you don't do this.
Reporting keyword: You will need to add a reporting keyword for each site in NETbilling. You can do this by going to "Site Tools" -> "Site Tags" -> "config" for each site -> under the section "Data Retrieval Interface", there is a box for "Access keywords" [Reporting Keyword]. You need to enter a keyword here to be added later in the NATS admin. You need to do this for each of your sites. Also, under "Account Setup" -> "Account Management" -> "Access Security" -> "Data Retrieval Interface", you need to check the box next to "Enable Data Retrieval Interface v1.x" and add your server's IP address to the "Reporting Client IP Addresses section". You need to do this to track rebills, refunds, chargebacks, etc.
Set up NETbilling in NATS
Important: You must have PHP's mcrypt installed in order to set up NETbilling. Please see the PHP documentation.
Billers Admin
To begin setting up NETbilling as a biller in NATS, go to the Billers Admin. Scroll down to the "Biller" drop-down menu, select NETbilling, and click "Add."
When prompted, fill in the 12-digit NETbilling Account Number that you received from NETbilling under the "Account Info" section. You can optionally enter your dynamic IP code as well. If you were not provided with this information, please contact your biller to receive it.
Sites Admin
Next, go to the Sites Admin, create or edit a tour, and scroll down to the "Biller Details" section. Enter your NETbilling Site Tag and Access Keyword [Reporting Keyword] here. You can find both of these by logging into NETbilling, going to Setup, Site Tools, and Site Tags -- the site tag can be found in the "Site tag" column on the main Site Tags screen, or under "Basic Information" on the edit site screen; the access keyword [Reporting Keyword] is under the Scriptable Reporting Interface link. You may also enter an Access Keyword [Control Keyword] for cross-sales and instant upgrades (see below). This can be found in Netbilling's admin. Just go to "Site Tools" -> "Site Tags", then click "config" on the site you want to set this up for. Your Access Keyword will be under the "Control CGI advanced options" section on the next page.
Once you have done this, scroll down to the section labeled "Join Options for this Tour" and click the "Edit Option Details for this tour" icon that corresponds to the join option you wish to use. In the "Biller Codes" section on the next page, locate the "NETBILLING" options. All of these options are optional -- simply fill out the provided fields if you wish to use these features.
Once you have completed these steps, save your join option details. NETbilling will now be configured for basic use as a biller in NATS.
NETbilling Cross Sales
Currently, NATS only supports NETbilling Gateway cross-sale between NATS clients.
In NETbilling, under "Account Setup" -> "Account Management" -> "Credit Cards" -> "Step 6", you need to check the box to "Enable PCI Repeat Billing". If you are going to be up-selling or cross-selling to your own NETbilling account, you do not need to enter any account numbers into the text box in Step 6. If you are going to be up-selling or cross-selling to different NETbilling accounts, you need to enter those NETbilling account numbers into the text box.
Outgoing Cross Sales
Account, Site Tag, Pass Code, Initial Days, Initial Dollars, Recurring Days, Recurring Dollars, Ref Code and Integrity Key are provided by the person you are sending cross sales to. The domain is the base domain of their NATS install. So if their NATS is at https://www.democash.com then https://www.democash.com is the domain you need to enter. Only set domain if the cross sale goes to another affiliate program. Domain should not be set if the cross sale is for another site in your program.
NATS will automatically display a checkbox accompanied by the description entered in the Cross/Up Sales Admin. If you enter a disclaimer in the Cross/Up Sales Admin then you can also access that via {$xsell.details.disclaimer}.
The main xsell tags available for use in this section are:
{$xsell.details.name}
{$xsell.details.description}
{$xsell.details.disclaimer}
You will also have to contact your partners and have them change the IP for you in their XSELL_NETBILLING_SECURE_IPS configuration variable. This can be found in either their config.php or their config_override.php.
In addition, you will need to have the sending IPs added to NETbilling's allowed IP list. If you do this, you DO NOT need to fill in "Dynamic IP Code" for the outgoing cross-sale. If you setup a cross sale verification code with them instead, then place this code in the field "Dynamic IP Code".
If the company who is sending you the cross sale does not have NATS, you can not use this method.
Please view our "Process Gateway Cross Sales Outside NATS" page.
Incoming Cross Sales
To set up an incoming cross sale, go to the Cross/Up Sales Admin and click on the Incoming Cross Sells tab. Select NETbilling from the Biller drop down menu, then select what site and program this cross sale relates to. Click Add New Option once you have selected those.
On the next page, you can select your site/program again. Under details, you will have to fill out the title of your cross sale. Initial Days, Initial Dollars, Recurring Days, and Recurring Dollars are the initial and recurring period and amounts for this option. Under Biller Info, you can also enter an Auth Amount, which is only necessary with a $0 initial join. You can also choose to disable AVS and disable Fraud Checking. Set up your discount upgrade price in NETbilling's system and add it to the Discount Upgrade Price field. When you are done configuring your cross sell, click Add New Option.
For affiliates to send you cross sales(or you to send cross sales to yourself), you'll need to add the IPs to XSELL_NETBILLING_SECURE_IPS configuration variable.
Upgrade Subscription
To set up an Upgrade subscription you need to use the following link in your limited members area for user upgrades:
https://<linkdomain>/signup/upgradeplus.php?site=<siteid>&username=<username>
Where <linkdomain> is the linkdomain for the site, <siteid> is the siteid for the site in NATS, and <username> is the username for the user that is trying to upgrade (To get the Username via PHP you would use <?=$_SERVER['REMOTE_USER']?>)
You will also need to add this line to your configuration file to turn on the trials with NETbilling; $config['NETBILLING_UPGRADES'] = 1;
Extra Biller Options
NETbilling has the following Extra Biller Fields available:
processor
Using NETbilling as a HTTPS Gateway
Please see our "HTTPS Gateways" page.
Auto Cascading to NETbilling
When you autocascade, your member does not get a chance to specify their username on the normal prejoin form. As a result, you must present this input on the gateway_join template.
{if !$available_data.username}
<TR><TD class="join_name">Username:</TD><TD class="join_value"><input class="join_input" type="text"
name="signup[username:1:6:16:::username_check]" value="{$mdata.username}"><span class="join_error">{if $errors.username}<br>{$errors.username}</span>{/if}</TD></TR>
{/if}
{if !$available_data.password}
<TR><TD class="join_name">Password:</tD><TD class="join_value"><input class="join_input" type="text"
name="signup[password:1:6:16:::password_check]" value="{$mdata.password}"><span class="join_error">{if $errors.password}<br>{$errors.password}</span>{/if}</TD></TR>
{/if}Up Sales
In the Configuration Admin, under the Billers section, you will need up add the IP of the system sending the upsell to the XSELL_NETBILLING_SECURE_IPS. Even your own IP will need to be added if you are sending this upsell to yourself.
If the Upsell is going to another NETbilling account, then the sender will need to enter a space-separated list of accounts that are authorized to use this feature under Authorized accounts in Step 6 of the Credit Card setup page.
Package Plus
NETbilling is one of the billers that supports Package Plus, allowing you to offer your members incentives to upgrade their memberships to a higher tier
For more information on Package Plus, visit the "Package Plus" page.
Cancel Plus
NETbilling is one of the billers that supports Cancel Plus, allowing for the cancellation of members.
For more information on Cancel Plus, visit the "Cancel Plus" page.
NETbilling Specific Configuration Settings
The following are additional NETbilling settings that can be configured in the Biller Section of the Configuration Admin.
Allow Create New Member NETbilling - Allows the creation of new members by posts from NETbilling.
NETbilling Automatic Upgrades - If set to yes, when a member tries to upgrade, NATS will remove the 'Trial' flag from the member without notifying the biller. When the member finishes their trial period, they will have full access according to NATS but will appear as if they did not upgrade at NETbilling.
NETbilling Poll Backdays - Number of backdays to poll for NETbilling.
Set Expire NETbilling Date - Determine whether NATS sets the biller expiration date or the NETbilling themselves.
Member Expire Pad NETbilling - Set whether to use the default member expiration padding for NETbilling.
Member Expire Pad NETBilling Days - Set the number of days to pad for member expirations.
NETbilling Allowed IPs - Set secure IP addresses that are allowed to post transaction information for NETBILLING.
Xsell NETbilling Secure IPs - Set the secure IP addresses that are allowed to post cross-sale transaction information for NETBILLING.
Allow NETbilling Process Gateway - Set whether NETbilling is given the ability to send posts to process gateway for cross-sales.
NETbilling Activate Member on Deduction Reversal - Set whether to reactivate members on deduction reversals.
NETbilling Chargeback Expires Now - Set whether to expire members immediately on chargeback transactions.
NETbilling Void Expires Now - Set whether to expire members immediately on voids.
NETBilling Credit Expires Now - Set whether to expire members immediately on credit.
NETbilling Retry Count - Set the number of times to retry if the gateway sends a declined response.
Gateway HTTPS NETbilling - Prefix this in front of the redirects to NETbilling join forms. This is exclusively for using HTTPS URLs for gateway join pages.
Caution is advised when using this setting and should not be used without a proper understanding of the process.
Gateway HTTPS NETbilling 1 - Prefix this in front of the redirects to NETbilling join forms (Billerid 1 only). This is exclusively for using HTTPS URLs for gateway join pages.
Caution is advised when using this setting and should not be used without a proper understanding of the process.
NETbilling PCI Compliant - Set this for more accurate upgrades with Netbilling. If this setting is set to "Yes", be sure to enable PCI-compliant billing, upgrade, and cross sales in your Netbilling Account.
NETbilling Expire Now - Set whether to force the NETbilling expiration poll to use the current time instead of the expiration time period.
NETbilling Credit No Cancel - Set this to prevent a member from being expired when a refund comes into NATS.
Allow NETbilling Zero Duration Auth - Set this to allow NATS to post NETilling Auth without durations, used on Token Sites with free options.
Allow NETBilling Zero Dollar Auth - Set this to allow NATS to post NETilling $0 Auth on the initial sale.
NETbilling Rename Username - Set this to allow NETbilling expired members to get renamed during the signup process so the same username can be re-used by a different user during the signup process.
Non Recurring Transactions
For non-recurring transactions, NETbilling does not send username information(and no NETbilling subscription is created). This means the transaction does not make a new member for non-recurring transactions. There are two ways you can change this:
NETBILLING_NONRECURRING_USERNAME forces NATS to send the username to Netbilling, appending the transaction date to the username. This makes sure all usernames remain unique in NETbilling.
NETBILLING_NONRECURRING_USERNAME_NODATE forces NATS to send the original, unmodified username to NETbilling for non-recurring signups.
You can turn these on in the config file using the following:
$config['NETBILLING_NONRECURRING_USERNAME_NODATE'] = 1;
$config['NETBILLING_NONRECURRING_USERNAME'] = 1;Additional Notes
To use these configs, make sure the Reuse Matching Username config is on. This can be done by navigating to the Configuration Admin's Surfer tab and searching for the Signup Form section.
In addition to this, ensure you turn on the following:
$config['NETBILLING_RENAME_USERNAME'] = 1;See Also
Post-Biller Templates - editing the Return URL pages
Gateway Tokens - NATS lets surfers purchase tokens through NetBilling. The surfer only needs to enter their payment information once to purchase an unlimited number of tokens.
Last updated
Was this helpful?