Difference between revisions of "NATS4 Epoch"
TMMStephenY (talk | contribs) |
|||
| Line 5: | Line 5: | ||
== Set up on Epoch Website == | == Set up on Epoch Website == | ||
| − | |||
| − | + | Before you can begin configuring Epoch as a [[Ct#Biller|biller]] in [[NATS4]], you must first register a merchant account with them. This can be done through their website at https://www.epoch.com/. Make sure to record your Company Account Code while registering. | |
| − | * Site Name: | + | Setup your site on [http://www.epochsystems.com/newsite/ Epoch's website] or send them an e-email using their [https://epoch.com/en/billing_contacts.html support form.] In either case, you must give Epoch the following information: |
| + | |||
| + | * Site Name: Your site name. | ||
* Pricing Options: List all pricing options you want Epoch to setup. They will send you product codes for each one. | * Pricing Options: List all pricing options you want Epoch to setup. They will send you product codes for each one. | ||
* Postback URL: <nowiki>http://linkdomain/signup/process_epoch.php</nowiki> | * Postback URL: <nowiki>http://linkdomain/signup/process_epoch.php</nowiki> | ||
| − | Replace ''linkdomain'' with your [[Link Domain|linkdomain]]. Record your Epoch Product Code for each site. | + | Replace ''linkdomain'' in the above example with your [[Link Domain|linkdomain]]. Record your Epoch Product Code for each site. |
| − | If you use a .htaccess password file and need Epoch to add and remove | + | If you use a .htaccess password file and need Epoch to add and remove logins to it, you also need to give them the following information: |
| − | logins to it, you also need to give them the following information: | ||
* Password File Path: The path to your password file on the server. | * Password File Path: The path to your password file on the server. | ||
| Line 52: | Line 52: | ||
on both tables. | on both tables. | ||
| − | == | + | == Setting Up Epoch in NATS == |
| − | + | === Billers Admin === | |
| − | + | To begin setting up Epoch as a [[Ct#Biller|biller]] in [[NATS]], go to the [[NATS4 Billers Admin|Billers Admin]]. Scroll down to the "Biller" drop-down menu, select "Paycom.net (Epoch Systems)," and click "Add." | |
| − | [[ | ||
| − | |||
| − | * No UserPass | + | '''Note:''' If you don't see Paycom.net/Epoch 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]]. |
| − | * EmailPlus Template | + | |
| − | * Retry Count | + | When prompted, fill in the Company Code that was provided to you by Epoch under the "Account Info" section. If you were not provided with this information, please contact your [[Ct#Biller|biller]] to receive it. |
| − | * Text Color | + | |
| − | * Background Color | + | === Sites Admin === |
| − | * Link Color | + | |
| − | * Error Text Color | + | Next, go to the [[NATS4 Sites Admin|Sites Admin]], create or edit a [[Ct#Tour|tour]], and scroll down to the "Biller Details" section. Edit any of the optional "EPOCH" settings available here -- these affect how certain elements on the Epoch [[Ct#Join Form|join form]] appear to your [[Ct#Member|members]]. The settings on this page include: |
| − | * EZClick Background Color | + | |
| − | * EZClick Text Color | + | * No UserPass - Disables Epoch password management @CHECK |
| − | * EZClick Title Background Color | + | * EmailPlus Template - The template to display for email plus |
| − | * EZClick Title Text Color | + | * Retry Count - The Number of times a surfer can retry the Epoch join form before denied. |
| − | * Top Images | + | * Text Color - The HTML Color for main text on Epoch join form. This should be in hex format. |
| + | * Background Color - The HTML Color for main background on Epoch join form. This should be in hex format. | ||
| + | * Link Color - The HTML Color for links on Epoch join form. This should be in hex format. | ||
| + | * Error Text Color - The HTML color for links on the Epoch join form. This should be in hex format. | ||
| + | * EZClick Background Color - The HTML Color for main background of EZClick Table if present. This should be in hex format. | ||
| + | * EZClick Text Color - The HTML Color for main text of EZClick Table if present. This should be in hex format. | ||
| + | * EZClick Title Background Color - The HTML Color for header background of the EZClick Table (if present). This should be in hex format. | ||
| + | * EZClick Title Text Color - The HTML Color for header text of the EZClick Table (if present). This should be in hex format. | ||
| + | * Top Images - Used when a client would like to personalize their join forms a bit more. These cannot contain images of models or any other copyrighted material. They're usually just the site logo. | ||
| + | |||
| + | 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 [[Ct#Join Option|join option]] you wish to use, or create a new [[Ct#Join Option|join option]]. In the "Biller Codes" section on the next page, locate the EPOCH Product Code and EPOCH List (optional) fields and enter your Product Code and List (optional). | ||
| + | |||
| + | Additionally you may wish to edit/add any additional [[NATS4 Rules|rules]] to allow this option to show on your [[Ct#Join Form|join page]]. You can do so with the purple arrows next to the Option row on the main Billers page. This is similar to the other [[NATS4 Rules|rules]] pages in [[NATS]]. | ||
== Notes == | == Notes == | ||
Epoch has multiple special features which we have directly integrated | Epoch has multiple special features which we have directly integrated | ||
into NATS. The following explains how to use each one: | into NATS. The following explains how to use each one: | ||
| − | |||
=== EZClick === | === EZClick === | ||
| Line 134: | Line 143: | ||
referring affiliate. | referring affiliate. | ||
--> | --> | ||
| − | |||
===EPOCH EXPIRE PAD=== | ===EPOCH EXPIRE PAD=== | ||
NATS gives you the ability to set an [[NATS4_MEMBER_EXPIRE_PAD|expire padding]] specific to EPOCH. This can be setup in the Configuration Admin -> Biller tab. | NATS gives you the ability to set an [[NATS4_MEMBER_EXPIRE_PAD|expire padding]] specific to EPOCH. This can be setup in the Configuration Admin -> Biller tab. | ||
Revision as of 13:25, 2 March 2011
Set up on Epoch Website
Before you can begin configuring Epoch as a biller in NATS4, you must first register a merchant account with them. This can be done through their website at https://www.epoch.com/. Make sure to record your Company Account Code while registering.
Setup your site on Epoch's website or send them an e-email using their support form. In either case, you must give Epoch the following information:
- Site Name: Your site name.
- Pricing Options: List all pricing options you want Epoch to setup. They will send you product codes for each one.
- Postback URL: http://linkdomain/signup/process_epoch.php
Replace linkdomain in the above example with your linkdomain. Record your Epoch Product Code for each site.
If you use a .htaccess password file and need Epoch to add and remove logins to it, you also need to give them the following information:
- Password File Path: The path to your password file on the server.
- Password Script URL: The URL of the epoch password script located on the same server as the site.
If you use MySql Auth for access verification, you also need to give them the following information. (Please use this method if possible.)
- Password File Path: Tell them to set this to your NATS site ID number
- Password Script URL: http://linkdomain/signup/passwd_epoch.php
Replace linkdomain with your linkdomain.
Set up DataPlus
You MUST setup DataPlus. If you don't, Epoch can't tell NATS about rebills, credits, or chargebacks.
Database Permissions
There are two tables in the NATS database for Epoch's DataPlus: EpochTransStats and MemberCancelStats. You need to create a user in MySQL comming from Epoch's IP range and grant that user insert and select privileges on the above two tables. Do that by logining into MySQL with root privileges and executing the following commands:
grant insert, select on <database>.EpochTransStats to <username>@'<IP Address Range>' identified by '<password>'; grant insert, select on <database>.MemberCancelStats to <username>@'<IP Address Range>' identified by '<password>'; flush privileges;
Replace <database> with the name of your NATS database. Replace <username> is the username for the Epoch user you are creating. Replace <password> with the password for the Epoch user you are creating. Ask Epoch for their IP address range and replace <IP Address Range> with that range.
Email the username and password you created along with the NATS database name and IP address to Epoch, and ask them to turn on DataPlus on both tables.
Setting Up Epoch in NATS
Billers Admin
To begin setting up Epoch as a biller in NATS, go to the Billers Admin. Scroll down to the "Biller" drop-down menu, select "Paycom.net (Epoch Systems)," and click "Add."
Note: If you don't see Paycom.net/Epoch as a biller in NATS4, put in a support ticket, as you may need an updated version of NATS.
When prompted, fill in the Company Code that was provided to you by Epoch under the "Account Info" section. 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. Edit any of the optional "EPOCH" settings available here -- these affect how certain elements on the Epoch join form appear to your members. The settings on this page include:
- No UserPass - Disables Epoch password management @CHECK
- EmailPlus Template - The template to display for email plus
- Retry Count - The Number of times a surfer can retry the Epoch join form before denied.
- Text Color - The HTML Color for main text on Epoch join form. This should be in hex format.
- Background Color - The HTML Color for main background on Epoch join form. This should be in hex format.
- Link Color - The HTML Color for links on Epoch join form. This should be in hex format.
- Error Text Color - The HTML color for links on the Epoch join form. This should be in hex format.
- EZClick Background Color - The HTML Color for main background of EZClick Table if present. This should be in hex format.
- EZClick Text Color - The HTML Color for main text of EZClick Table if present. This should be in hex format.
- EZClick Title Background Color - The HTML Color for header background of the EZClick Table (if present). This should be in hex format.
- EZClick Title Text Color - The HTML Color for header text of the EZClick Table (if present). This should be in hex format.
- Top Images - Used when a client would like to personalize their join forms a bit more. These cannot contain images of models or any other copyrighted material. They're usually just the site logo.
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, or create a new join option. In the "Biller Codes" section on the next page, locate the EPOCH Product Code and EPOCH List (optional) fields and enter your Product Code and List (optional).
Additionally you may wish to edit/add any additional rules to allow this option to show on your join page. You can do so with the purple arrows next to the Option row on the main Billers page. This is similar to the other rules pages in NATS.
Notes
Epoch has multiple special features which we have directly integrated into NATS. The following explains how to use each one:
EZClick
Epoch's EZClick lets you add special offers to your epoch join forms which can make you extra money. NATS lets you to put EZClicks on your join forms and also lets you let others use EZClicks on their join forms to cross-sell one of your products.
To add an EZClick to one of your join forms, you must click the cross sells icon in the option's code row the EZClick should appear on. There you can simply add EZClicks you have setup previously.
To setup new EZClicks, use the same icon located on the very bottom of each page (Cross Sell Admin) with all the other Admin icons. There you can add and edit Cross Sells for all supported billers.
To offer one or more of your products to others as EZClicks, contact support@epoch.com and tell them to setup a new EZClick. Give them the product code or codes (you may setup an EZClick with 2 offers) and tell them to pre-check them or not.
Now you have to setup Incoming Cross Sells via the Cross Sell Admin. This is explained on the Cross Sell Admin page directly.
UpgradePlus
Epoch UpgradePlus lets you shorten a Member's Trial by offering them incentives to upgrade in your Members Area. Most users do this by offering them two separate Members Areas. One for members that are only in their Trial Phase giving them only limited amount of content and a separate one which gives access to the full content for people that paid for the full month.
There are two ways to use this system:
- MySQL Auth: If you use MySQL Auth in your Server to authenticate members using the NATS members table you can add an additional check to see if a member is in their trial or full membership and give them the right access respectively.
- Your own System: You could also use the Site's Upgrade Post URL you can setup via the NATS Site Admin to receive upgrade notifications to your own scripts. Your scripts would then mark the member in a way you can figure out what to give them access to. We can not help you with setting up such a script though.
To use UpgradePlus on your site, you must follow the instructions located in the Epoch UpgradePlus documentation except for the following:
- UpgradePlus URLs: The buttons or links you use to open Epoch UpgradePlus should not use the URL mentioned ( but instead you should use http://<linkdomain>/signup/upgradeplus.php?site=<siteid>&username=<username>
- Template returnurl: The returnurl variable you need to add to the accept offer button as mentioned in the documentation needs to be set to the following URL: http://linkdomain/signup/epoch_upgradeplus_returnurl.php
Replace <linkdomain> with the site's linkdomain. Replace <siteid> with the site's number, replace <username> with the upgrading user's username. (To get the Username with PHP, use <?=$_SERVER['REMOTE_USER']?>)
EPOCH EXPIRE PAD
NATS gives you the ability to set an expire padding specific to EPOCH. This can be setup in the Configuration Admin -> Biller tab.
