Please don't test your biller setup with NATS4 StandardBill's test account—it won't work correctly.
NATS3 StandardBill
Setting Up On StandardBill's Website
If you wish to become a merchant and use StandardBill as a payment processor in NATS4, you must first register an account at their website-- http://www.standardbill.com.
Please note: StandardBill 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 StandardBill terms.
To process transactions, in the StandardBill administration panel under "Setup" -> "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 StandardBill if you don't do this.
Reporting keyword: You will need to add a reporting keyword for each site in StandardBill. 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. Also, 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.
Setting Up StandardBill in NATS
Before you can begin setting up StandardBill in NATS4, you must first have PHP's mcrypt function installed. Please see the official PHP documentation for more information.
Billers Admin
To begin setting up StandardBill as a biller in NATS4, go to the Billers Admin. Scroll down to the "Setup New Biller" drop-down menu, choose StandardBill, and click Add.
Note: If you don't see StandardBill, put in a support ticket, as you may need an upgraded version of NATS.
When prompted, enter your StandardBill Account ID and Dynamic IP code. Once you have filled in the required fields, click Save.
Sites Admin
Next, go to the sites admin, create or edit a tour, and scroll down to the "Biller Details" section. Enter your StandardBill Site Tag and Access Keyword [Reporting Keyword]. You can find both of these by logging into StandardBill, going to Setup, Site Tools, and Site Tags -- the site tag is on the main browse sites screen; the access keyword [Reporting Keyword] is under the Scriptable Reporting Interface link. You may also enter an Access Keyword [Control Keyword] for cross-sells and instant upgrades (see below).
StandardBill Cross Sales
In StandardBill, under "Setup" -> "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 StandardBill 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 StandardBill accounts, you need to enter those StandardBill account numbers into the text box.
To begin setting up cross sales in NATS4, go to the Upsells Admin. On this page, you will see tabs for both outgoing and incoming cross sales. Instructions for both types of transactions are provided below:
Outgoing Cross Sales
To begin setting up an outgoing cross sale in NATS4, click the "Outgoing Cross Sales" tab at the top of the page. Select StandardBill from the "Biller" drop-down menu and click "Add New Option".
When prompted, enter your Account, Site Tag, Pass Code, Initial Days, Initial Dollars, Recurring Days, Recurring Dollars, Ref Code and Integrity Key. These should be provided by the person you are sending cross sells to.
The domain is the base domain of their NATS install. For example, if their NATS is at http://www.democash.com, then http://www.democash.com is the domain you need to enter. Only set the domain if the cross sell goes to another affiliate program. The 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 Upsells Admin. If you enter a disclaimer in the Upsells Admin then you can also access that via the {$xsell.disclaimer} Smarty function.
You will also have to contact your partners and have them change the ip
for you in their XSELL_STANDARDBILL_SECURE_IPS configuration variable. This can
be found in either their config.php or their config_override.php file.
Incoming Cross Sales
To set up an incoming cross sale, go to the Upsells Admin and click on the Incoming Cross Sells tab. Select StandardBill from the "Biller" drop down menu, then select what site and program this cross sale applies to. Click "Add New Option" once you have selected those options.
On the next page, you can select your site/program again. Under details, fill out the title of your cross sale. Initial Days, Initial Dollars, Recurring Days, and Recurring Dollars are the initial and recurring period and costs for this join 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 StandardBill's system and add it to the Discount Upgrade Price field. When you are done configuring your cross sale, 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 necessary IPs to your XSELL_STANDARDBILL_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:
- http://<linkdomain>/signup/upgradeplus.php?site=<siteid>&username=<username>
In the above example, <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 StandardBill; $config['STANDARDBILL_UPGRADES'] = 1;
Additional information
OrbitalPay does not support recording IPv6 addresses, NATS has a config setting called "ORBPAY_USE_IPV4_PLACEHOLDER" which will only send IPv4 addresses to Netbilling during the signup process.
