ePay.bg Gateway WooCommerce

A plugin that allows you to extend your WooCommerce installation with the ePay.bg payment processor

Checkout payment option
  1. Upload the `woocommerce-gateway-epaybg` folder to the `/wp-content/plugins/` directory.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.
  3. Navigate to `WooCommerce > Settings > Payment Gateways` to configure the ePay.bg gateway settings.
  4. For alternative installation using the WordPress Admin panel | Click Here
  5. If you need help on how to upload and activate a WordPress plugin click here.

Steps for configuration of your ePay.bg installation are devided into two parts.

Steps are done in a testing environment with a testing account, but they are pretty much the same with the live account.

  1. Go to epay.bg and login.
  2. Go to Personal Settings

    Personal Settings
  3. You will see your personal/merchant details. Click on the Merchant Details link

    Edit Merchant Details
  4. From there you are taken to the merchant account setup, where you should click the edit button

    Edit Account
  5. Then in the next page enter your details and mainly the Response URL(URL за известяване). You will find this URL in the Gateway settings description.

    Enter Response URL
  6. Just save on the next page and you will see the saved merchant details page again.

    Saved Details
  7. That’s it here. Move on to the store gateway settings.
  1. Login to your WooCommerce store
  2. Enable the gateway
  3. Choose the test or live mode.
  4. Enter your Merchant Identification Number.
  5. Enter your Merchant Email.
  6. Enter ePay secret word.
  7. Enter how many day you want the order to stay in the ePay.bg system before it expires.
  8. Choose the language you want the ePay.bg pages to be in.
  9. Choose the Payment Types, you want to offer as options of payments to your Customers. ePay, CC/Debit card, EasyPay, BPay.
  10. Enter the EasyPay instructions to your customers. Only, if you chose EasyPay as a Available Payment Type Here you have the chance to give specific instructions to your customers on how to pay for their order.
  11. Enter the BPay instructions to your customers. Only, if you chose BPay as a Available Payment Type Here you have the chance to give specific instructions to your customers on how to pay for their order.
  12. Save Changes.
  13. Recommended: make a few test payments before you go live. In live mode make a couple small live test payments, too.
  • Enable ePay.bg Bulgaria.
    • Here you choose you integration method, depending on what account you have.
  • Test Mode
  • Method Title
    • The title of the gateway displayed on the checkout page.
  • Description
    • The description displayed on the checkout page.
  • Merchant Identification Number
    • Please enter your ePay.bg MIN (Merchant Identification Number) for identification by the system.
  • Merchant Email
    • Please enter your ePay.bg Merchant Email for identification by the system.
  • ePay Secret Word
    • Please enter your ePay.bg secret word.

      Settings
  • Notify URL
    • Copy this URL to your Notify URL field in your merchant account ‘Notifications for WEB Payments’.
  • Order Expiration
    • Please enter the time the order will stay active in the ePay.bg system. Time is specified in days and cannot be more than 30 days, please write in a single number only ( example: 6 ).
  • ePay.bg Pages Language
    • Choose the languge you want the ePay.bg pages to be in. Bulgarian is default.
  • Available Payment Types
    • Choose the payment types you can offer to the customers. Contact ePay.bg for more information on how to enable support for the payment types for your account.
    • Choices are ePay.bg, Credit/Debit card, EasyPay, BPay
  • EasyPay Instuctions
    • Give the customer instructions for paying on a EasyPay cash desk, and let them know that their order won’t be shipping until the money is received.
    • Only, if you chose EasyPay as a Available Payment Type.
  • BPay Instructions
    • Give the customer instructions for paying via BPay ATM, and let them know that their order won’t be shipping until the money is received.
    • Only, if you chose BPay as a Available Payment Type.
  • Available Payment Types
    • Choose the payment types you can offer to the customers. Contact ePay.bg for more information on how to enable support for the payment types for your account.
    • Types are: ePay.bg, Credit/Debit Card, EasyPay, BPay ( Payment through an ATM )
  • Debug Log
    • Debug log will provide you with most of the data and events generated by the payment process.
      Settings cont.

       

The different payment options available require contract with ePay.bg. They are not automatically enabled on your merchant account and in most cases they have to be requested in order to work. Please contact ePay.bg for more information. Here are how the different options work.

  1. ePay.bg: The customer is redirected to epay.bg payment page, where he has to either create an account or login with an existing epay account. After that he is able to pay with any of the available options he has activated in his account.

    Checkout epay redirect
  2. Credit/Debit Card: The customers are redirected to a Borica payment page, where they can pay using their Credit or Debit cards. This option also supports 3D secure steps. After a successful transaction the customer is returned to your store.

    Checkout Credit/Debit Card
  3. EasyPay: The customers are redirected to the Thank You page and presented with their EasyPay payment code. With the code, they are also presented with the payment instructions you have written for them.

    EasyPay Instructions
  4. BPay: The customers are redirected to the Thank You page and presented with their BPay payment code and merchant code. They are also presented with the payment instructions you have written for them.

    BPay Instructions

Please visit the plugin changelog page for more information.