Difference between revisions of "NATS4 GXBill"
TmmStephen (talk | contribs) |
|||
| (One intermediate revision by one other user not shown) | |||
| Line 1: | Line 1: | ||
{{Not Finished}} | {{Not Finished}} | ||
| − | {{ | + | {{NATS5 Manual |
| − | | show_billers_section = true | + | |show_billers_section = true |
}} | }} | ||
| − | + | {{NATS4 Manual}} | |
{{Test Billers Disclaimer}} | {{Test Billers Disclaimer}} | ||
== Setting up on GXBill's Website == | == Setting up on GXBill's Website == | ||
| Line 43: | Line 43: | ||
'''Bypassing the need for the user to enter pre join form data.''' | '''Bypassing the need for the user to enter pre join form data.''' | ||
| − | + | *Go to the "Special Payment Options" section in the [[NATS4 Sites Admin|Sites Admin]], and select GXBill from the "Biller" drop-down menu. Fill in your desired Join Form Text -- for example: "No Credit Card? Pay by Phone." If GXBill provides you with a Type to fill in, you can fill it into the "Type" field here as well. | |
| − | Go to the "Special Payment Options" section in the [[NATS4 Sites Admin|Sites Admin]], and select GXBill from the "Biller" drop-down menu. Fill in your desired Join Form Text -- for example: "No Credit Card? Pay by Phone." If GXBill provides you with a Type to fill in, you can fill it into the "Type" field here as well. | ||
Once you have completed these steps, save your [[Ct#Join Option|join option]] details. GXBill will now be configured for basic use as a [[Ct#Biller|biller]] in [[NATS]]. | Once you have completed these steps, save your [[Ct#Join Option|join option]] details. GXBill will now be configured for basic use as a [[Ct#Biller|biller]] in [[NATS]]. | ||
Latest revision as of 13:22, 20 February 2020
NATS 4
|
|---|
Please don't test your biller setup with NATS4 GXBill's test account—it won't work correctly.
Setting up on GXBill's Website
Before you begin setting up GXBill in NATS, you must first register a merchant account with them. This can be done through their website at http://www.GXBill.com/.
When registering with GXBill, make sure to take down the Merchant ID, Password, Site Code, and Type that are provided to you by your biller. This information will be necessary for setting up GXBill in NATS4.
Set the password script to:
Simply replace "linkdomain" in the above example with your linkdomain.
Set up GXBill in NATS
Billers Admin
Add GXBill as a biller, Click the "Billers Admin" tab from the menu and at the bottom of the "Current Billers" table, choose GXBill from a drop down list and click add. When prompted, fill in the GXBill Merchant ID and Password that were provided to you by GXBill under the "Account Info" section.If you were not provided with this information, please contact your biller to receive it.
- Your 4 digit GXBill Merchant ID is:
- Your password when you signed up at GXBill is:
Note: If you don't see GXBill as a biller in NATS4, put in a support ticket, as you may need an updated version of NATS.
Sites Admin
Next, go to the Sites Admin, create or edit a tour, and scroll down to the "Biller Details" section. Enter your GXBill Site Code here for each site you wish to configure, into the field marked "GXB Site Code."
In the field / screen that says: GXB Allow Return? (optional) If the box here is checked by default, please uncheck it. Please make sure this box is not checked!
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, enter the GXBill Type (if necessary) into the "GXB Type" field.
Unless you are making customizations by limiting products types, please ignore the parameter under each 'Join Option' in NATS for GXB - GXB (id:7) Type: (optional) 99% of the time this can be ignored. If you are in any doubt about this please contact your GXBill account rep.
The join form text should read something like: "Pay by Phone/SMS/EU Banking". Once you have completed these steps, save your join option details. If necessary, add a new cascade to get the GXBill payment option up on the join page to display.
Bypassing the need for the user to enter pre join form data.
- Go to the "Special Payment Options" section in the Sites Admin, and select GXBill from the "Biller" drop-down menu. Fill in your desired Join Form Text -- for example: "No Credit Card? Pay by Phone." If GXBill provides you with a Type to fill in, you can fill it into the "Type" field here as well.
Once you have completed these steps, save your join option details. GXBill will now be configured for basic use as a biller in NATS.
Pay Per Signup with GXBill
By default, GXBill transactions that are not labeled as "dialer" transactions by GXBill will be counted as initials and will pay out on pay per sign up, on which you may not intend to have a payout. These transactions will be labeled as "Phone", "SMS" and "Debit" (elv) transactions with GXBill.
If you would not like to pay out on pay per signup programs, you will need to set up a payout change for GXBill for each pay per signup program you have set up. To set this up, first go to the Programs Admin and click on "Edit Payout Changes" next to the pay-per-signup program for which you would like to add a payout change.
This will show you a list of the current payout changes and the default payouts for this program. To add a payout change, click the "Add Payout Change" tab on the top-left navigation tabs of this page. (If no payout changes have been set up, only the default payouts will be displayed.)
When setting up a payout change for your pay-per-signup programs, you will want to set up a "Standard Change" from the "Change Type" drop-down menu and select each GXBill biller from the list of Billers for which you want to be affected by this payout change.
Once created, you will be able to add the values you would like to set for GXBill payout change:
- First, set the $Join and $Rebill values to zero, which correspond to your pay-per-signup payout.
- Next, set the % Join percentage and % Dialer percentage to the desired value. GXBill "dialer" transactions will still pay out based on the % Dialer percentage and all other transactions will payout on the % Join (and % Rebill if there is a "Debit" transaction that can rebill).
Finally, if you navigate back to the list of payout changes for this program, you will see a priority list of all payout changes. NATS will choose which payout change to use based on the priority of the payout changes which are listed from top to bottom. If you want to ensure that the newly added GXBill Payout Change will always be used to calculate payouts for GXBill transactions, make sure to move the payout change to the top of the list of payout changes by clicking the up arrow next to the payout change. (Up and down arrows to modify payout change priority will only appear if there is more than one payout change.)
Geo-Target Banners
GXBill can replace the Pay by Phone text with the words "Pay by Phone" in a user's native language. To enable this feature, edit the NATS join template and make the following change:
Remove the following line:
<input type="submit" class="button" name="special[{$optionid}]" value="{$option_name}">
Replace it with the following line:
{if $optionid == 'xx'}
<input class="join_button" type="image" name="special[{$optionid}]" src="http://www.gxplugin.com/banners/image.php?id=MERCHANTID&site=SITEID&skin=default">
{else}
<input class="join_button" type="submit" name="special[{$optionid}]" value="{$option_name}">
{/if}
Setting "xx" to be the optionid in question. Complete your change by logging in to your GXBill account and getting the extra banners. In the new code above, replace MERCHANTID and SITEID with the Merchant ID and Site ID that you wish to associate with these banners.
