StandardBill

Article Topics: Billers, Cross Sales, Up Sales, One Click Systems

Please Note: Please don't test your biller setup with NATS StandardBill's test account—it won't work correctly.

Setting Up On StandardBill's Website

If you wish to become a merchant and use StandardBill as a payment processor in NATS, you must first register an account at their website-- https://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 NATS, 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 NATS, go to the Billers Admin. Scroll down to the "Setup New Biller" drop-down menu, choose StandardBill, and click Add.

Please 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 NATS, go to the Cross/Up Sales 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 NATS, 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 Cross/Up Sales Admin. If you enter a disclaimer in the Cross/Up Sales 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 Cross/Up Sales 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

StandardBill does not support recording IPv6 addresses, NATS has a config setting called "STBILL_USE_IPV4_PLACEHOLDER" which will only send IPv4 addresses to StandardBill during the signup process.