You are using an unsupported browser. Please update your browser to the latest version on or before July 31, 2020.
close
We have a new home for our Segpay Knowledge Base articles! Check out: https://gethelp.segpay.com/
announcement close button
Home > Integrate with Segpay > Segpay Integration with NATS
Segpay Integration with NATS
print icon

Introduction

Log into the Segpay Merchant Portal to begin setting up your Price Points, Postbacks, and Packages (see the next sections for step-by-step instructions).

 

Be sure to check your system with NATs to see if an update is needed to setup Segpay. If you have an older NATs version, please be sure that your version is updated to match the information contained in this document.

 

To integrate your site with Segpay and NATS, review this article: NATS4 Segpay

 

 

 If you set up Segpay and NATS prior to August 2006, it's extremely important that your POST BACK NOTIFICATION PROFILES are updated, otherwise users won’t be added or deleted correctly, and your transactions will not be updated correctly.

 

What you need:

Contact your Segpay Sales Rep to request the following:

  • Pricing: Provide your Segpay Sales Rep the pricing you want to offer your customers.
  • User Name & Access Key: Email Segpay Tech Support at [email protected] and ask to create a User Name and Access Key for Segpay Reporting Services (SRS).

Follow the instructions in the next sections of this document.


Adding Segpay as a Biller in NATS

 

Follow these steps to add Segpay as a Biller in NATS:

  1. Go to Billers Admin.
  2. Scroll down to the Biller drop-down menu.
  3. Select Segpay.
  4. Click Add.
  5. When prompted, enter your Segpay Merchant ID (MID), and SRS Username & Access Key.

 

If you do not have this as an option, you may need to reach out to NATs for an updated version.

 


Adding Price Points

Price Points are known as “Order ID” in NATs.  Segpay supports Recurring, One-Time, Digital Purchase, and Instant Conversion pricing at a static price.

 

To add a new Price Point:

 

  1. Log into the Merchant Portal: https://mp.segpay.com/
  2. Go to My Websites > Price Points
  3. Click Add Price Points to create a new Price Point.
  4. Type a description in the Description field.
  5. Select a Price Point Type:
  6. Select User Info Settings to collect on Pay Page:
  7. Enter Pricing Information:
  8. Click Save.

 

ℹ  If you're looking for something more flexible for your customers, we offer Dynamic Pricing that supports one-time payments, as well as Dynamic Recurring that supports recurring subscriptions.  Provide your Segpay Sales Rep with your lowest & highest desired price point range to ensure this range is approved by Compliance for integration.  Please note Instant Conversion, Dynamic Pricing, and Dynamic Recurring Price Points require Compliance approval. 

 


Setting Up Postbacks

Please note that Postbacks will need to be configured to your site’s NATs link domain (examples can be seen below). If you're managing your own members, NATs will only require a Disable and a Transaction Postback to be configured on Segpay’s end.   

 

To add a new Postback: may be added in the Segpay Merchant Portal under My Websites --> Manage Postbacks --> Add New Postback.  

 

  1. Log into the Merchant Portal: https://mp.segpay.com/
  2. Go to My Websites > Manage Postbacks
  3. Click Add New Postback:
  4. Enter a description:
  5. Disable Postback:
    linkdomain/signup/process_segpay.php?action=<action>&username=<extra username>&password=<extra password>&purchaseid=<purchaseid>
    Expected Response: *success*

  6. Transaction Postback
    linkdomain/signup/process_segpay.php?action=<action>&stage=<stage>&approved=<appr oved>&name=<billname>&email=<billemail>&country=<billcntry>&state=<billstate>&city=< billcity>&address=<billaddr>&transtype=<trantype>&purchaseid=<purchaseid>&transid=<tr anid>&price=<price>&username=<extra username>&password=<extra
    password>&currencycode=<currencycode>&eticketid=<eticketid>&memberid=<extra foreignid>&session=<extra natssess>&merchantpartnerid=<extra
    merchantpartnerid>&xsellnum=<xsellnum>&upsell=<extra upsell>&tokenplus=<extra tokenplus>&octoken=<extra
    octoken>&cardtype=<cardtype>&paymenttype=<paymenttype>&xref1=<extra
    xref1>&xref2=<extra xref2>
    Expected Response: *success*

  7. Reactivation (optional)
    linkdomain.com/signup/process_segpay.php?action=<action>&stage=<stage>&approved=< approved>&name=<billname>&email=<billemail>&country=<billcntry>&state=<billstate>&c ity=<billcity>&address=<billaddr>&transtype=<trantype>&purchaseid=<purchaseid>&transi d=<tranid>&price=<price>&username=<extra username>&password=<extra
    password>&currencycode=<currencycode>&eticketid=<eticketid>&memberid=<extra foreignid>&session=<extra natssess>&merchantpartnerid=<extra
    merchantpartnerid>&xsellnum=<xsellnum>&transGUID=<transguid>

    Expected Response: *success*

 

 ℹ Postbacks that are configured with expected Error Responses will be retried upon failure.  To be notified of failed postback notifications, please enter your email where prompted.  You may also enter a username/password if your script is behind a password-protected area.


Creating a Package

Once your Price Points & Postbacks have been created, they will need to be added to a Package, also known as “CC eTicket ID” in NATs.  Once the Price Point(s) have been added to your Package(s), these values will need to be added to your NATS Join Options.  

 

Upon creating a new package, the package status will default to Test Mode.  A Segpay Employee will need to make the final switch from Test Mode to Live Mode when you are ready.  Be sure to click Save once finished. 

 

  1. Log into the Merchant Portal: https://mp.segpay.com/
  2. Go to My Websites > Manage Packages
  3. Click Add Package
  4. Type a description
  5. Add URL
  6. Add Postback
  7. Click Save
  8. Click Pricing tab to add your Price Points
  9. Click Save
  10. Add your Package ID in NATS Join Options

 


Adding Cross Sales

Cross-Sells may be added in the Packages menu.  Your list of approved Cross Sells will be listed here.  If you would like to offer a NEW Cross Sale, please provide the Segpay Package ID and Price Point ID to [email protected] so they may work with Compliance to get your Cross Sales approved & tested. 

 

This Cross Sell Configuration may be seen in the Segpay Merchant Portal under My Websites --> Manage Packages --> Edit the package of your choosing --> Select "Cross Sell Configuration" tab once inside the package: 

 

  1. Log into the Merchant Portal:
  2. Go to My Websites > Manage Packages
  3. Click Edit for the package you want to edit
  4. Select the Cross Sell Configuration tab for the package

 

 

NATS Instructions for Cross Sales

Incoming Cross Sell (allows a surfer to purchase access to your site through your merchant partner’s join form). *Note, to process an incoming cross sell, you must have a Cross Sell program configured First*

  1. Upsells Admin
  2. Click the “Incoming Cross Sells” tab
  3. Select Segpay as the biller
  4. Select the Site/Program this Cross Sale will apply to
  5. Displays title as well as given description/disclaimer.  Also displays if cross sell is enabled/disabled for all join options.
  6. Biller Info – Displays any relevant information required by the biller (Package ID/Price Point ID goes here)

 

Outgoing Cross Sell (allows surfers to register for other sites from your join form).  *Note, to process an outgoing cross sale, you must first configure your incoming cross sells*

  1. Upsells Admin
  2. Click the “Outgoing Cross Sells” tab
  3. Select Segpay as the Biller
  4. Select the Site/Program this Cross Sale will apply to.
  5. Displays title as well as given description/disclaimer.  Also displays if cross sell is enabled/disabled for all join options.
  6. Biller Info – Displays any relevant information required by the biller (PackageID/Price Point ID/Ref Code).

 

**Information for the “Ref Code” field, found in the Biller Info Section, can be retrieved from your NATs cross sales page** 

 

Setting Up a Cross Sale for your own Merchant Account

a.    Create Price Point & Package, these values will need to be added in your NATs, where you will confirm the expected NATs Xref value with us.
b.    Provide to [email protected], who will submit to Compliance for approval.
c.    Once approved, this new cross sale will be available to add to your Package(s) under the Cross-Sell Configuration tab.
d.    Provide Segpay a link to test your new offer, where we will confirm the Xrefs are being passed to the Segpay pay page.
e.    Once tested successfully, your packages will be flipped live!
 

Setting Up a Cross Sale with a Merchant Partner

a.    Notify Segpay who will be offering the main Sale, and who will be offering the Cross Sale.
b.    Create Price Point & Package, these values will need to be added in your NATs, where you will confirm the expected NATs Xref value with us.
c.    Provide to [email protected], who will submit to Compliance for approval.
d.    Once approved, this new cross sale will be available to add to your Package(s) under the Cross-Sell Configuration tab.
e.    Provide Segpay a link we can use to test your new offer, we will confirm the Xrefs are being passed to the Segpay pay page.
f.    Once tested successfully, your packages will be flipped live!

 


Upsells

NATS

Outgoing (lets you sell upgrades to your members)
a.    Upsells Admin
b.    Outgoing Upsells Tab
c.    Scroll to the bottom, select Segpay in the Biller drop-down
d.    Click Add

 

Incoming (lets other sites sell upgrades to your members)
a.    Upsells Admin
b.    Incoming Upsells Tab
c.    Scroll to the bottom, select Segpay in the Biller drop-down
d.    Click Add

 

Segpay Merchant to Merchant Upsell


a.    Create (one click enabled) Price Point & Package
b.    Compliance Approval (eticket & cross merchant one click approval)
c.    Merchant adds Price Point (Order ID) & Package ID (eTicket ID) in NATs for their Upsell offer.

 


NATS Upgrade Plus (Segpay Instant Conversio*Members will now be able to take advantage of the NATs Upgrade Plus feature.*n)

This feature allows you to offer a limited-access trial period and allow consumers to convert to a full membership early, without having to wait for the trial to end.  The Instant Conversion offer will be valid up to 12 hours before the end of the trial.   
Please note, this Price Point Type requires Compliance Approval. 

 

Create an Instant Conversion Price Point

  1. Enter Initial & Recurring amounts as you would for a Recurring Price Point:

  2. Add Additional Instant Conversion Settings

  3. Discount Price: Give your customers an incentive to upgrade early by offering a discount.  The price you enter here is what they will be charged (initial and recurring) if they choose to instantly convert

  4. Adjust Trial Length At Time of Conversion: Select this option to set the customer’s rebill date 30 days (or length of your recurring billing interval) from the day they chose to convert.  Leave unchecked and the rebill date will remain 30 days from when the trial was originally supposed to end, rewarding the customer for converting early with extra “free access.

  5. Support Stand-In: Transactions, where Segpay is unable to communicate with the bank, are temporarily approved - and retried up to three times every two hours - until the bank authorizes or declines the transaction, or the maximum number of retries is exceeded.

  6. Ensure postback parameter ‘&transguid<transguid>’ is added to your Trans Post, as

 

*Members will now be able to take advantage of the NATs Upgrade Plus feature.*

 


NATs Token Plus (Segpay One Click)

One Click payments allow customers who have already bought from you to make additional purchases without having to re-enter the card information.   
Before you can enable Token Plus in NATs, you must have a Token Site set up in the Sites Admin.

 

Token Plus (in NATS)

a.    Sites Admin, Add a Site, choose “Token” from the “Site Type” options, save.
b.    Sites Admin, locate Token Site, click “Set Join Options” action icon
c.    Edit existing or add new Join Option that you want to enable Token Plus for
d.    Check the “Token Rebuy Allowed” setting, save
 

 

One Click (in Segpay)

a.    Edit Price Point ID (NATs Order ID)
b.    Check the “One Click” box

 

 


Join Links

 a.    eTicket
 b.    Join Link
 c.    x-auth & x-decl // Cascade

 d. redirect inserts --> change receipt template to NATS

Save changes once complete. 

 


 

Testing Your Configuration

You are ready to take payments; however, your account is initially in Test Mode, meaning no actual charges are processed yet. Follow the steps below to run a payment in Test Mode before we set your account to Live:   

 


Going Live

After testing, please contact Segpay Technical Support ([email protected]) to have your account set to Live mode. A technical integration specialist will run an additional end-to-end test to ensure everything is working properly, and let you know when you’re ready to start taking payments.  Some things to keep in mind before going Live with NATs: 

 

-    Did you enter the right account information in the Billers Admin?
-    Did you set up all your sites?
-    Did you set up the Segpay Join Options in the Sites Admin?
-    Did you set up a Join Form for each site?
-    Did you set up at least one cascade?
-    Did it cascade correctly on approval/failure?
-    Were you able to sign-up up successfully?

 


Getting Help

If you need help or have suggestions for this feature, please contact us at [email protected].

Feedback
248 out of 418 found this helpful

scroll to top icon