NATS4 Bill1st Gateway
Setting Up at Bill 1st
Before you can begin configuring Bill1st Gateway in NATS, you must first sign up for an account with them. To do so, go to their site at: http://www.bill1st.com.
Record any essential information you receive during the signup process.
You must also set up the following Postback URLs with Bill1st:
- Initial Postback URL - http://<linkdomain>/signup/process_bill1st.php
- Event Postback URL - http://<linkdomain>/signup/process_bill1st.php
Replace <linkdomain> with your NATS linkdomain or domain.
Setting Up Bill 1st in NATS
Billers Admin
To begin setting up Bill 1st in NATS, go to the Billers Admin. Scroll down to the "Setup New Biller" drop-down menu and select "Bill1st Gateway" from your list of choices. Click Add.
Note: If you don't see Bill1st Gateway, put in a support ticket, as you may need an updated version of NATS.
You will then be prompted for your Account ID, and Password. These will have been provided by Bill1st when signing up for an account. If you were not given this information, please contact Bill1st. You can also choose whether you want to use your Affiliate ID in NATS as your Bill1st Username-- this setting is optional. When you are done configuring these options, click Save.
Sites Admin
Next, go to the Sites Admin, create or edit a tour, and scroll down to the "Join Options for this Tour" section. Create a join option that you wish to enable Bill1st Gateway for, or click the "Edit Option Details for this tour" action icon next to an already existing join option.
On the next page, you will find various fields labeled "BILL1ST" under the Biller Codes column. Fill in the requested Product Codes and Upgrade Codes; these must be obtained from Bill 1st. Once you have filled in the required fields, click Save.
If you setup Dynamic Pricing at Bill1st, you will be provided a Product Code to identify the dynamic option. When NATS sends a dynamic option product code, Bill1st uses the Initial, Initial days, Rebill, and Rebill Days (Membership Site) or the Amount and number of Tokens (Token Site) from the NATS join option. But, you need to also tick the Dynamic option checkbox on the NATS Join option.
Additionally, you must add rules in order for this join option to be displayed on your join page. You can do so by using the "Rules" action icon, marked with purple arrows. For more information on Rules in NATS4, please see our NATS4 Rules wiki article.
Upsells Admin
Bill1st Gateway also supports cross sales and upsells in NATS4. If you wish to use Bill1st Gateway to process cross sales and upsells, you must first configure them on the Bill1st website. Please contact Bill1st for assistance with this.
Cross Sales
To configure outgoing cross sales in NATS4, go to the Upsells Admin and click on the "Outgoing Cross Sells" tab. Add Bill1st from the Biller drop-down menu, and click Add New Option. On the next page, you will be prompted to fill in the Title, Description, and Disclaimer for your cross sell option.
You will then need to fill out the Biller Info for your cross sale, which will be provided by Bill1st. Fill in your Account ID, Product Code, Ref Code, and Domain. You can also choose if you want to send an HTTPS Post when a cross sale transaction occurs with Bill1st Gateway, or if you want to recalculate your ref code. When you have finished configuring your option, click Save Changes.
If you wish to configure an incoming cross sale in NATS4, go to the Upsells Admin and click on the "Incoming Cross Sells" tab. Add Bill1st from the Biller drop-down menu, select the Site and Program you want your incoming cross sale to affect, and click "Add New Option".
You will then be prompted to input a title for your cross sale option, as well as the initial and recurring membership fees and lengths. Once you have filled these fields out, input the Product Code and Upgrade Code that you received from Bill1st, and click Save Changes.
Before you can process cross sales in NATS, you will need to allow the IP of the system sending the cross sale. You can do this in the Configuration Admin in the "Billers" section. Scroll down to the Bill1st section, and add your desired IPs to the XSELL_BILL1ST_SECURE_IPS configuration option.
Upsells
To configure outgoing upsells in NATS4, go to the Upsells Admin and click on the "Outgoing Upsells" tab. Add Bill1st from the Biller drop-down menu, and click Add New Option. On the next page, you will be prompted to fill in the Title, Description, and Disclaimer for your upsell option.
You will then need to fill out the Biller Info for your upsell, which will be provided by Bill1st. Fill in your Account ID, Product Code, Ref Code, and Domain. You can also choose if you want to send an HTTPS Post when an upsell transaction occurs with Bill1st Gateway, or if you want to recalculate your ref code. When you have finished configuring your option, click Save Changes.
If you wish to configure an incoming upsell in NATS4, go to the Upsells Admin and click on the "Incoming Upsells" tab. Add Bill1st from the Biller drop-down menu, select the Site and Program you want your incoming upsell to affect, and click "Add New Option".
You will then be prompted to input a title for your upsell option, as well as the initial and recurring membership fees and lengths. Once you have filled these fields out, input the Product Code and Upgrade Code that you received from Bill1st, and click Save Changes.
Before you can process upsells in NATS, you will need to allow the IP of the system sending the upsell. You can do this in the Configuration Admin in the "Billers" section. Scroll down to the Bill1st section, and add your desired IPs to the XSELL_BILL1ST_SECURE_IPS configuration option.
