WooCommerce Integration

Merchants running a shop using WordPress with WooCommerce can process payments through Segpay. Just follow the instructions below to install the Segpay plugin.

Prerequisites: WordPress, WooCommerce Plugin

Open Source Platform: https://woocommerce.com/

Pre-Installation Checklist

Before installing the WooCommerce plugin, complete these steps first:

  1. Create a Segpay account, if you do not have one already: http://segpay.com

  2. Ask your Segpay Account Rep to do the following:

    • Set up dynamic pricing for your account.
      As part of that process, you will be approved for a maximum purchase amount that can be submitted from your cart.

    • Send you the plugin installation zip file for Woocommerce.
      Save the file to a folder on your computer.

    • Create a Username and Access Key for SegPay Reporting Services (SRS).

  3. Review our Getting Started documentation for help setting up packages and postbacks, and generating an EticketId. Feel free to reach out to your Segpay rep for help with this, as well.

  4. Login to the Segpay Merchant Portal to set up a Transaction Postback (Trans post).

    1. Enter the following in the URL field: (Populate YOUR_SITE_URL with the actual domain where this request will go).

      YOUR_SITE_URL?segpay_notify=1&action=<action>&approved=<approved>&trantype=<trantype>&purchaseid=<purchaseid>&tranid=<tranid>&price=<price>&currencycode=<currencycode>&eticketid=<eticketid>&ip=<ipaddress>&desc=<desc>&name=<billname>&firstname=<billnamefirst>&lastname=<billnamelast>&email=<billemail>&phone=<billphone>&address=<billaddr>&city=<billcity>&state=<billstate>&zipcode=<billzip>&country=<billcntry>&billertranstime=<transtime>&invoiceid=<extra invoiceid>

    2. Enter “OK” in the Expected Response field for the Transaction Postback

Installing the Plugin

  1. Log into your Wordpress site and go to: Admin > Plugins > Add New.

  2. Click Upload Plugin.

  3. Click Choose File and select the zip file that your Segpay Rep sent to you.

  4. Click Install Now.

  5. Once the plugin is installed, go to Plugins > Installed Plugins (if you are not redirected there automatically) and activate the Segpay Gateway for WooCommerce.

  6. Go to WooCommerce > Settings, and select the Checkout tab along the top of the page and then click Segpay

  7. Select the checkbox next to Enable Segpay Payment Module.

  8. Click Save Changes at the bottom of the page, and the following fields are displayed:

    Title: Segpay (pre-populated)

    Description: Pay securely by Credit or Debit Card through Segpay Secure Servers. (pre-populated)

    eTicket ID: Enter your custom eTicketID, in the format XXXXXX:YYYY. From Pre-Installation step 3 above.

    Username/Password: Enter your SRS Username and Access Key. From Pre-Installation step 2c above.

    Live Payment URL: https://secure4.segpay.com/billing/poset.cgi (pre-populated).

    Price Hash URL:http://srs.segpay.com/PricingHash/PricingHash.svc/GetDynamicTrans (pre-populated).

    Refund URL:http://srs.segpay.com/ADM.asmx/RefundTransaction (pre-populated).

    Authorized Text: Transaction Successful (pre-populated).

    Declined Text: Transaction Failed (pre-populated).

  9. Click Save Changes at the bottom of the page.

Testing

You’re 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:

  1. Place an order in your shop, proceed to checkout, enter billing info and select Segpay. Click Place Order.

  2. On the Segpay Payment page, enter your card details and click Complete This Secure Purchase.

  3. You should see a Success page confirming your test payment went through, and then redirected back to your shop’s website.

    If you are not taken back to your shop automatically, click Transaction Successful.

    TIPS: Note that you can customize this message by going to WooCommerce > Settings and look for the Authorized Text field.

  4. Go back to the WordPress Admin area and click WooCommerce > Orders.

    You will see the test order listed. Click to view it.

  5. Click Refund to test that you can refund a payment (see image below). Then click Refund via Segpay.

Going Live

After testing, please contact Segpay Technical Support (techsupport@segpay.com) 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.