NATS4 Netbilling Native
Please don't test your biller setup with NATS4 Netbilling Native's test account—it won't work correctly.
Note: this article is about using Netbilling as a native NATS biller. For the Netbilling gateway, please see the Netbilling article
Set up on Netbilling's Website
Register an account on Netbilling's website.
Please note: Netbilling uses the term Access Keyword to describe two different settings. To distinguish the two different settings, I've placed my own terms in brackets after the Netbilling terms.
Under "Setup" -> "Sitetags" -> "config" for each site, set the Postback CGI URL to the following URL:
- http://linkdomain/signup/process_nbnative.php
Replace linkdomain with your linkdomain.
Next you must set the NBNative Return URL, also known as the "GiveUp URL" in their site configuration, to the following URL:
- http://linkdomain/signup/returnurl_nbnative.php
Replace linkdomain with your linkdomain.
In order to ensure that rebills, credits, and other refunds are correctly retrieved by your NATS install, you should make sure you have the NetBilling " Enable Scriptable Reporting Interface" option selected and keywords added to site site. You can do this by going to "Setup" -> "Sitetags" -> "config" for each site -> under the section "Scriptable Reporting 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. Under "Setup" -> "Access Security" -> "Scriptable Reporting Interface", you need to check the box next to "Enable Scriptable Reporting 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
You must have PHP's mcrypt installed. Please see the PHP documentation.
There are several versions of the Netbilling protocol. Please follow the instructions that apply to your setup.
Netbilling Version 3
In the Billers Admin, select Netbilling Native from the Biller drop-down menu. Enter your 12 digit NetBilling account number. This number is displayed on the top of the first page when you log in to Netbilling. When adding it to the Billers admin please suffix a colon to the number; for example: 123456789012:. Enter your integrity key next-- this can also be found in Netbilling's site.
In the Sites Admin, edit the tour you want Netbilling Native active for, and scroll down to Biller Details. Under Biller Details, enter your Site Tag and Reporting Keyword in the available "NBNATIVE" fields. You can find both of these by logging into Netbilling, going to Setup, Site Tools, Site Tags -- the site tag is on the main browse sites screen; the Reporting Keyword under the Scriptable Reporting Interface link. You may also enter an Access Keyword [Control Keyword] for instant upgrades (see below).
You can find your form ID in the Netbilling admin under "Setup' -> "Form editor". You can either create a new form, or edit an existing form to gather the form ID value.
Upgrade Subscription
To set up an Upgrade subscription, use the following link in your limited members area for user upgrades:
- http://<linkdomain>/signup/upgradeplus.php?site=<siteid>&username=<username>
Replace <linkdomain> with your linkdomain. Replace <siteid> with your site ID number. Replace <username> with the name of the user trying to upgrade.
See Also
- Post-Biller Templates -- editing the Return URL pages
- Netbilling v3 Upgrade Instructions -- upgrading Netbilling from version two to version three
