View source for SegPay

{{NATS3 Manual
| show_billers_section = true
}}

{{Test Billers Disclaimer}}

[http://segpayeu.com/documents/2.0/SegpayNatsSetupInfo.pdf Segpay's instructions]

== Set up on SegPay's Website ==

Before you can begin configuring SegPay as a [[Ct#Biller|biller]] in [[NATS3]], you must first register a merchant account with them. This can be done through their website at http://www.segpayeu.com/.

While registering with SegPay, make sure to take down the User ID, Access Key, E-Ticket IDs, and Order ID that are provided for you. This information will be necessary for setting up SegPay as a [[Ct#Biller|biller]] in [[NATS3]].

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 userid or access key, but now you must enter them both.

=== 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. You need to enter
this information into 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_segpay.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>&currencycode=<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* 

== NATS Member Management ==
This section describes 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_segpay.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_segpay.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_segpay.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>&currencycode=<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 will need to enter the
following information shown below. '''This must be entered''' in order for
receipts to go out.

* Sign-Up Template: email.signup.xml
* Rebill Template: default
* Cancel Template: email.cancel.xml
* Expiration Template: default

Once you have filled in all the appropriate fields, click on the UPDATE
button and your profile will be saved. Once you have a NATS Postback
Config you can use that postback config in all of your Packages that
work with NATS.

== Packages ==
In order to finish setting up NATS at Segpay, for each package that
uses NATS, you will need to enter nats into the Result Page field.

== Setting up Segpay in NATS ==
=== Billers Admin ===

To begin setting up SegPay as a [[Ct#Biller|biller]] in [[NATS]], go to the [[NATS3 Billers|Billers Admin]]. Scroll down to the "Biller" drop-down menu, select SegPay, and click "Add."

'''Note:''' If you don't see SegPay as a [[Ct#Biller|biller]], [https://clients.toomuchmedia.com put in a support ticket], as you may need an updated version of [[NATS]].

When prompted, fill out your transaction and [[Ct#Chargeback|chargeback]] fees, along with when you wish to deduct them. Fill in the User ID, Access Key, Username (optional), and Password (optional) that were provided to you by SegPay under the "Account Info" section.

User ID and Access Key correspond to the username (userid) and password (access key) that you would use to login to the ''my.segpay.com'' admin. This information is important, as it is necessary in order to pull data reporting from the SegPay system regarding your transaction information and user information for cancels and expirations. Username and Password are the username and password you would use to log into SegPay to check reporting. These can be different from above.

=== Sites Admin ===

Next, go to the [[NATS3 Sites|Sites Admin]], create or edit a [[Ct#Site|site]], and scroll down to the "Biller Details" section. Find the "SegPay" settings, and enter the E-Ticket IDs for the payvia types you have set up with SegPay -- you can choose to process credit card, check, or direct debit (elv) transactions through this [[Ct#Biller|biller]].

'''Note:''' As of version '''3.1.68.3''', [[NATS]] now supports Direct Debit (elv) as an processing type for [[Ct#Member|member]] transactions through SegPay. If you want to add Direct Debit (elv) compatibility to SegPay, please [https://www.toomuchmedia.com/nats_patches.htm download the necessary biller patch] or [https://clients.toomuchmedia.com put in support ticket] to be upgraded to the latest version of [[NATS]].

You can find your E-Ticket IDs by going to Merchant Setup -> Packages in the SegPay admin. Pick the package from the available choices in the drop-down menu, and you will see the details of that package. The Package ID is the same as the E-Ticket ID that you will enter at NATS. For example, a Package/E-Ticket ID will look like 106580: . You will always need the : after the 6 digit package number in [[NATS]].

Use the "Custom Auth Text" field to display a custom message to [[Ct#Surfer|surfers]] when they are approved. For example, you may want to enter something like "Click Here to Login to the Members Area." Use the "Custom Decline Text" field to display a custom message to [[Ct#Surfer|surfers]] when they are declined. For example, you may want to enter something like "Click Here to Try Another Payment Option."

After you have completed the previous steps, scroll down to the "Join Options this Site Offers" section of the page, and create or edit a [[Ct#Join Option|join option]] to add SegPay compatibility. Under "Biller Codes for this Join Option," enter the SegPay Order ID that you received from your [[Ct#Biller|biller]].

SegPay Order ID determines a price point for your Package. Since you can offer several price points with each Package, be sure to pay attention to which Order ID value you are looking for. You can find your price points in the bottom half of your Package information in the SegPay admin. Use the Scroll bar on the bottom of the "Price Points" box and scroll to the right until you find the ID field. This ID is the number you will need to enter in the Order ID field in [[NATS]]. For each price point you have in NATS, you need to have each of those in the package.

'''Note: If you input an incorrect E-Ticket ID and Order ID combination in the [[NATS3 Sites|Sites Admin]], your [[Ct#Cascade|cascade]] will stop at that step with an error message. Please make sure that you test each E-Ticket ID and Order ID combination you have set up to make sure that they work.'''

SegPay CC E-Ticket Override, SegPay Check E-Ticket Override, and SegPay Direct Debit (elv) E-Ticket Override are all optional settings that allow you to set up a [[Ct#Join Option|join option]] in a different E-Ticket. By using this feature, you can switch out the E-Ticket specified above in "Biller Details."

Save your changes once you have finished filling out the required fields here. SegPay will now be configured for basic use as a [[Ct#Biller|biller]] in [[NATS3]].

=== Cross Sells ===

SegPay supports [[Ct#Cross Sell|cross sell]] transactions through [[NATS]]. In order to process cross sale transactions, however, you will first have to set them up with your [[Ct#Biller|biller]]. Please contact SegPay for assistance with this.

You will need to add the following to your Trans Post URL:
<tt>&eticketid=<eticketid>&xref=<xref></tt>. Segpay will then provide you with an E-Ticket ID for each cross sell. The E-Ticket IDs are formatted as follows; ''site:product''.

If you are sending a [[Ct#Cross Sell|cross sell]] to another one of your [[Ct#Site|sites]], go to the "Incoming" section. Choose SegPay from the [[Ct#Biller|Biller]] drop-down menu, and click Add. When prompted, choose the [[Ct#Site|site]] and [[Ct#Program|program]] you want to associate with the cross sale, and fill in the "Comment" field.

Under "Data," fill in the E-Ticket ID (site) and Order ID (product) that you received when setting up cross sales with SegPay. Finally, fill in your desired [[Ct#Initial Bill|Initial]] Days (length of initial membership) and [[Ct#Rebill|Rebill]] Days (length of rebilled membership). You can also choose if you want this [[Ct#Cross Sell|cross sell]] to be a [[Ct#Trial Sign-up|trial membership]].

You will then need to set up a corresponding Outgoing [[Ct#Cross Sell|cross sell]] for the Incoming cross sell that you just set up. Click the "Outgoing" tab, choose SegPay from the "Biller" drop-down menu, and click "Add." Fill in your Ref Code here, and click Edit. You can obtain your Ref Code from the Cross Sells Reseller page. You can then activate the incoming cross sell with as many join options as you like, and activate them inside of Segpay.

By default, the [[Ct#Cross Sell|cross sells]] will be credited to which ever [[Ct#Affiliate|affiliate]] account that you use to get the code that is entered under Ref Code. If you want to credit cross sells to the reseller that sent the original signup you can turn on the following configuration variable:
''$config['XSELL_SEGPAY_RESELLER']''.

== Notes ==
You will have to change the minimum characters on your NATS [[ct#Join Form|join form]] to
8. To do this, edit your Join form and locate the this line:

<pre>
<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>
</pre>

Change the '6' that is highlighted to an '8' and it will work fine.

[[Category:NATS3 Billers]]