NATS4 SegPay
Note: Segpay's instructions may be more up to date.
Setup your NATS program site with SegPay. You must update your Postback Notification Profiles or users won't be added or deleted correctly and your transactions won't be updated. Previously you didn't need to enter a user I.D. or access key, but now you must enter them both.
Set up on SegPay's Website
Segpay Member Management
If you only use NATS for cascading and affiliate tracking and you use Segpay for your password management, you only need to enter information in the 2nd Trans Post URL field and MSG for each profile.
Set this as the 2nd Trans Post URL in each one of your current Postback Notification Profiles:
- 2nd Trans Post URL: linkdomain/signup/process_tmmsegpay.php?action=<action>&stage=<stage>&approved=<approved>&name=<billname>&email=<billemail>&country=<billcntry>&state=<billstate>&city=<billcity>&address=<billaddr>&transtype=<trantype>&purchaseid=<purchaseid>&transid=<tranid>&price=<price>&username=<extra username>&password=<extra password>¤cycode=<currencycode>&eticketid=<eticketid>&memberid=<extra foreignid>&session=<extra natssess>&merchantpartnerid=<extra merchantpartnerid>&xsellnum=<xsellnum>
- 2nd Trans Post Message (You must include the * before and after the word success): *success*
You need to record the following information when you setup SegPay join options. On the Merchant Setup page, under Packages, choose a package and record the Package I.D.; the I.D. number ends with a colon. In the package information section of the SegPay site, setup your join options; for each option, record the SegPay Order I.D.
NATS Member Management
The section is what you need to enter if you are using NATS for everything including your member management. You should only need to create one profile, "NATS", for all your packages at Segpay since all the data is going to the same place.
To create this, go to https://my.segpay.com. Go to MERCHANT SETUP->POST BACK. Click on the button to create NEW POSTBACK CONFIG. For DESCRIPTION, this is where you would enter the name NATS. Fill in the following in bold for each field, replacing linkdomain with that of the site:
- Inquiry URL:
linkdomain/signup/process_tmmsegpay.php?action=<action>&username=<extra username>&memberid=<extra foreignid>
- Inquiry Result Good: *success* (You must include the * before and after the word success)
- Access Enable URL: THIS FIELD IS NOT USED.
- Access Enable MSG: THIS FIELD IS NOT USED.
- Access Disable URL: linkdomain/signup/process_tmmsegpay.php?action=<action>&username=<extra username>&password=<extra password>&purchaseid=<purchaseid>
- Access Disable MSG: *success* (You must include the * before and after the word success)
- Cancel URL: THIS FIELD IS NOT USED.
- Cancel Match: THIS FIELD IS NOT USED.
- 2nd Trans Post URL: linkdomain/signup/process_tmmsegpay.php?action=<action>&stage=<stage>&approved=<approved>& name=<billname>&email=<billemail>&country=<billcntry>&state=<billstate>&city=<billcity>&address =<billaddr>&transtype=<trantype>&purchaseid=<purchaseid>&transid=<tranid>&price=<price>&user name=<extra username>&password=<extra password>¤cycode=<currencycode>&eticketid=<eticketid>&memberid=<extra foreignid>&session=<extra natssess>&merchantpartnerid=<extra merchantpartnerid>&xsellnum=<xsellnum>
- 2nd Trans Post Message: (You must include the * before and after the word success): *success*
Under the EMAIL TEMPLATES section, you must enter the following information so that receipts to go out.
- Sign-Up Template: email.signup.xml
- Rebill Template: default
- Cancel Template: email.cancel.xml
- Expiration Template: default
After you fill in all the appropriate fields, click on the UPDATE button and your profile will be saved. After you have a NATS Postback configuration, you can use that postback configuration in all of your Packages that work with NATS.
Packages
For each SegPay package that uses NATS, enter "nats" into the Result Page field.
Setting up SegPay in NATS
Billers Admin
To begin setting up SegPay as a biller in NATS, go to the Billers Admin. Scroll down to the "Biller" drop-down menu, select SegPay, and click "Add."
Note: If you don't see SegPay as a biller in NATS, put in a support ticket, as you may need an updated version of NATS4.
When prompted, fill in the Merchant ID, User ID, and Access Key that were provided to you by SegPay 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. Enter the E-Ticket ID that you set up on SegPay's website for each Pay Via Type you wish to use. You can also use the optional Custom Auth Text and Custom Decline Text fields to determine what you wish to display to the surfer on the SegPay approval and denial pages.
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, locate the "SEGPAY Order ID" field, and enter the Order ID you received from SegPay for the join option you are configuring. You can also put in a E-Ticket number in the "SEGPAY E-Ticket Override" fields (both CC and Check), which replaces the E-Ticket that you specified in the "Biller Details" section.
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 (similar to the several other areas across NATS).
Cross Sells
You need to add the following to your Trans Post URL in order to process cross sells: &eticketid=<eticketid>&xref=<xref>. Segpay will then provide you with an E-Ticket ID for each cross sell. The E-Ticket I.Ds. are formatted as follows: site:product.
To set up cross sales in NATS, go to the Upsells Admin and click "Incoming" or "Outgoing" cross sales from the navigation tabs at the top of the page (depending on whether you are receiving or sending the cross sale).
If you are sending a cross sale to another site, go to the "Outgoing Cross Sales" page. Add SegPay 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 should have been provided to you by SegPay. Fill in your Ref Code here, and click Save Changes.
If you are receiving the cross sale in question, go to the "Incoming Cross Sales" page. Add SegPay from the "Biller" drop-down menu and click Add New Option. When prompted, choose the site and program you want to associate with the cross sale.
Under "Details," fill in the title of your cross sale option, the initial fee and length, and the recurring membership fee and length. Finally, fill in the CC E-Ticket ID, Check E-Ticket ID, and Order ID that were provided to you by SegPay. In this section, your "E-Ticket ID" corresponds to your site, and your "Order ID" corresponds to your join option. Once you have filled out the available fields, you will be able to activate your cross sell options.
By default, your cross sells will be credited to the account you used to get the code entered under Ref Code. If you would like to credit cross sells to the reseller that sent the original signup, you can enable the following configuration variable: $config['XSELL_SEGPAY_RESELLER'].
Currently Segpay does not support Direct Debit (elv) xsells
Notes
Change the minimum characters on your NATS join form to 8. To do this, edit your Join form and locate the this line:
<TR><TD class="join_name">Username:</TD><TD class="join_value"><input class="join_input" type="text"
name="signup[username:1:6:16:::username_check]" value="{$vars.username}"><span class="join_error">{if $errors.username}<br>{$errors.username}</span>{/if}</TD></TR>
Change the '6' into an '8' and it will work fine.
