Difference between revisions of "NATS4 Netbilling Native"
From TMM Wiki
Jump to navigationJump to searchTMMStephenY2 (talk | contribs) |
|||
| (9 intermediate revisions by 6 users not shown) | |||
| Line 1: | Line 1: | ||
| − | {{ | + | {{NATS5 Manual |
| − | | show_billers_section = true | + | |show_billers_section = true |
}} | }} | ||
| + | {{NATS4 Manual}} | ||
{{Test Billers Disclaimer}} | {{Test Billers Disclaimer}} | ||
| Line 12: | Line 13: | ||
''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.'' | ''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 " | + | Under "Site Tools" -> "Site Tags" -> "config" for each site, set the Postback CGI URL to the following URL: |
* ''<nowiki>http://linkdomain/signup/process_nbnative.php</nowiki>'' | * ''<nowiki>http://linkdomain/signup/process_nbnative.php</nowiki>'' | ||
| Line 18: | Line 19: | ||
Replace ''linkdomain'' with your [[ct#Link Domain|linkdomain]]. | Replace ''linkdomain'' with your [[ct#Link Domain|linkdomain]]. | ||
| − | Next you must set the NBNative Return URL | + | Next you must set the NBNative "Return URL" and the "GiveUp URL" in their site configuration, to the following URL: |
* ''<nowiki>http://linkdomain/signup/returnurl_nbnative.php</nowiki>'' | * ''<nowiki>http://linkdomain/signup/returnurl_nbnative.php</nowiki>'' | ||
| Line 24: | Line 25: | ||
Replace ''linkdomain'' with your [[Ct#Link Domain|linkdomain]]. | Replace ''linkdomain'' with your [[Ct#Link Domain|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 | + | 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 Data Retrieval Interface v1.x" option selected and keywords added to site site. You can do this by going to "Site Tools" -> "Site Tags" -> "config" for each site -> under the section "Data Retrieval 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. |
| − | == Set up Netbilling in NATS == | + | You need to do this for each of your sites. Under "Account Setup" -> "Account Management" -> "Access Security" -> "Data Retrieval Interface", you need to check the box next to "Enable Data Retrieval 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 Version 3 in NATS == | ||
You must have PHP's [[mcrypt]] installed. Please see the | You must have PHP's [[mcrypt]] installed. Please see the | ||
[http://php.net/mcrypt PHP documentation]. | [http://php.net/mcrypt PHP documentation]. | ||
| − | + | === Billers Admin === | |
| + | |||
| + | To begin setting up Netbilling Native as a [[Ct#Biller|biller]] in [[NATS]], go to the [[NATS4 Billers Admin|Billers Admin]]. Scroll down to the "Biller" drop-down menu, select Netbilling, and click "Add." | ||
| + | |||
| + | '''Note:''' If you don't see Netbilling Native as a [[Ct#Biller|biller]] in [[NATS4]], [https://clients.toomuchmedia.com put in a support ticket], as you may need an updated version of [[NATS]]. | ||
| + | |||
| + | When prompted, fill in the 12 digit Netbilling Account Number, Integrity Key, and Dynamic IP Code (Optional) that were provided to you by Netbilling under the "Account Info" section. This information can be found on Netbilling's website -- if you were not provided with this information, please contact your [[Ct#Biller|biller]] to receive it. | ||
| + | |||
| + | === Sites Admin === | ||
| − | + | Next, go to the [[NATS4 Sites Admin|Sites Admin]], create or edit a [[Ct#Tour|tour]], and scroll down to the "Biller Details" section. Enter your Netbilling Native Site Tag and Reporting Keyword in the available "NBNATIVE" fields. | |
| − | |||
| − | + | You can find both of these by logging into Netbilling's website, going to Site Tools -> Site Tags -- the site tag is on the main Browse Sites screen, and the Reporting Keyword is under the Data Retrieval Interface link. You may also enter an Access Keyword [Control Keyword] if you wish to enable instant upgrades (see below for more information). | |
| − | You can find your form ID in the Netbilling admin under | + | You can find your form ID in the Netbilling admin under Processing Options -> Payment Form -> Form Editor on Netbilling's website. You can either create a new form, or edit an existing form to gather the form ID value. |
=== Upgrade Subscription === | === Upgrade Subscription === | ||
| Line 48: | Line 58: | ||
with your site ID number. Replace ''<username>'' with the name of the | with your site ID number. Replace ''<username>'' with the name of the | ||
user trying to upgrade. | user trying to upgrade. | ||
| + | |||
| + | === Upsells Admin === | ||
| + | |||
| + | For xsells & upsells, Netbilling Native requires the IP address of the outgoing upsell to be added to your $config['XSELL_NBNATIVE_SECURE_IPS']. | ||
| + | <br>For internal xsells & upsells you will need to add your server IP(s) to this config. | ||
| + | * If you are already using the $config['XSELL_NETBILLING_SECURE_IPS'], NBNative will also check this config as well. | ||
| + | |||
| + | == Package Plus == | ||
| + | The NetBilling Native Package Plus integration will be available after NATS5.0.X.X. If you would like to use the NetBilling Native Package Plus feature prior to this release, please send us a ticket. For more information on Package Plus, visit the [[NATS4 Package Plus|Package Plus]] wiki. | ||
== See Also == | == See Also == | ||
| Line 53: | Line 72: | ||
* [[Netbilling v3 Upgrade Instructions]] -- upgrading Netbilling from version two to version three | * [[Netbilling v3 Upgrade Instructions]] -- upgrading Netbilling from version two to version three | ||
| − | [[Category: | + | [[Category:NATS4 Biller Instructions]] |
Latest revision as of 11:43, 30 August 2021
NATS 4
|
|---|
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 "Site Tools" -> "Site Tags" -> "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" and 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 Data Retrieval Interface v1.x" option selected and keywords added to site site. You can do this by going to "Site Tools" -> "Site Tags" -> "config" for each site -> under the section "Data Retrieval 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 "Account Setup" -> "Account Management" -> "Access Security" -> "Data Retrieval Interface", you need to check the box next to "Enable Data Retrieval 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 Version 3 in NATS
You must have PHP's mcrypt installed. Please see the PHP documentation.
Billers Admin
To begin setting up Netbilling Native as a biller in NATS, go to the Billers Admin. Scroll down to the "Biller" drop-down menu, select Netbilling, and click "Add."
Note: If you don't see Netbilling Native as a biller in NATS4, put in a support ticket, as you may need an updated version of NATS.
When prompted, fill in the 12 digit Netbilling Account Number, Integrity Key, and Dynamic IP Code (Optional) that were provided to you by Netbilling under the "Account Info" section. This information can be found on Netbilling's website -- if you were not provided with this information, please contact your biller to receive it.
Sites Admin
Next, go to the Sites Admin, create or edit a tour, and scroll down to the "Biller Details" section. Enter your Netbilling Native Site Tag and Reporting Keyword in the available "NBNATIVE" fields.
You can find both of these by logging into Netbilling's website, going to Site Tools -> Site Tags -- the site tag is on the main Browse Sites screen, and the Reporting Keyword is under the Data Retrieval Interface link. You may also enter an Access Keyword [Control Keyword] if you wish to enable instant upgrades (see below for more information).
You can find your form ID in the Netbilling admin under Processing Options -> Payment Form -> Form Editor on Netbilling's website. 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.
Upsells Admin
For xsells & upsells, Netbilling Native requires the IP address of the outgoing upsell to be added to your $config['XSELL_NBNATIVE_SECURE_IPS'].
For internal xsells & upsells you will need to add your server IP(s) to this config.
- If you are already using the $config['XSELL_NETBILLING_SECURE_IPS'], NBNative will also check this config as well.
Package Plus
The NetBilling Native Package Plus integration will be available after NATS5.0.X.X. If you would like to use the NetBilling Native Package Plus feature prior to this release, please send us a ticket. For more information on Package Plus, visit the Package Plus wiki.
See Also
- Post-Biller Templates -- editing the Return URL pages
- Netbilling v3 Upgrade Instructions -- upgrading Netbilling from version two to version three
