Borica(Legacy) for WooCommerce

This plugin allows you to use Borica payment gateway within your WooCommerce store.

Checkout option

In the payment process, your customers are redirected to a BORICA secure payment page

borica-payment-page

BORICA accepted currencies are Bulgarian Lev(BGN), US Dollar(USD) and Euro(EUR). To accept each currency you need to obtain a virtual terminal in the currency from your bank

Upload the `woocommerce-gateway-borica` folder to the `/wp-content/plugins/` directory.
Activate the plugin through the ‘Plugins’ menu in WordPress.
Navigate to `WooCommerce > Settings > Checkout > Borica` to configure the Borica gateway settings.

  1. Upload the ‘woocommerce-gateway-borica‘ folder to the ‘/wp-content/plugins/‘ directory.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.
  3. Navigate to `WooCommerce > Settings > Payment Gateways > Borica` to configure the Borica gateway settings.
  4. IMPORTANT: Provide Borica with your “Return URL”. The URL is on top of the plugin settings page usually it is http://domain.com/wc-api/WC_Gateway_Borica
  5. For alternative installation using the WordPress Admin panel | Click Here
  6. If you need help on how to upload and activate a WordPress plugin | Click Here.

Steps for configuration of your Borica installation.

  • Login to your WooCommerce store
  • Go to `WooCommerce > Settings > Checkout > Borica`

The main section contains the settings used for activation, test mode and Terminal ID.

  1. Enable the plugin
  2. Choose if you want to use Testmode
  3. Enter the Gateway Title for the checkout page.
  4. Enter the Gateway Description for the checkout page.
  5. Enter your Merchant Terminal ID. It should be provided to you by Borica or your bank.
  6. Choose the language, which the Borica payment pages will be in. Bulgarian or English
Main Settings

Enable debug log generation. It will be useful when testing or looking for potential problems.

This section contains the information needed by the plugin to create certificate signing requests. Even if you already have your certificates in advance, you should fill this section. Only after all fields are filled in and saved, the next section Certificate Generation will be displayed.

IMPORTANT: All fields in the section should be filled in with Latin letters.

  1. Enter Your name or your domain name
  2. Enter Your company name
  3. Enter Business name. This could be the name of your online store or the particular business you are using the plugin for.
  4. Enter the City of your company.
  5. Enter the Province of your company.
  6. Enter your company email address or your store email address.
  7. Enter your eTLog username.
Information for CSRs

These three sections contain the means to generate and/or save the required certificates for the Borica gateway integration. All three sections are the same in functionality.

Generate a new Private Key:

  1. Click the Generate Private Key button
Generate New Private Key

Save an already existing Private Key:

  1. Click on the “I have a Private key, let me save it” radio button
  2. Paste the contents of the Private Key in the text area below
  3. Click the Save Private Key button
Save Existing Private Key

Download the Certificate Signing Request and send it to your bank for signing:

  • To download the Certificate Signing Request, just click on the green button “Download Certificate Signing Request
Download CSR

Save the signed Public Key (Certificate):

  1. Open the .cer file that your bank sent you. Or go to your eTLog system (test or live) > Borica Certificate > copy your certificate.
  2. Paste the certificate in the Public Key field.
Save Public Key

Save Changes

Download eTLog .p12 certificate:

  1. Go through the above settings for Private and Public keys
  2. When you have saved them both, you will see a button on the bottom to Download your .p12 certificate
  3. Press the “Download the public key in .p12 format” button
Download .p12 format

I – The .p12 certificate requires a password to import into the browser. How do I add a password?

To add a password to the p12 certificate you will need to use a WordPress filter:

  1. Use the following code snippet: https://gist.github.com/vanbo/373acf5da34fa362aeaaa469958696b6. Add your own password in the “set_your_pass” space and add the snippet to your “themes/your-theme/functions.php” file (at the bottom of the file)
  2. Export the file with the instructions from “Download eTLog .p12 certificate” section
  3. Import the file into your browser (that is Settings > Certificates > Personal > click “Import” button > add the file) and enter your chosen password when prompted to.

II – I added all certificates and when I test a payment, I return to the store with an error “Проверката на подписа за безопасност е неуспешна. Моля свържете се с администратор за повече информация.” or “Signature verification failed. Please contact the administrator for more information.”. The payment is successful, but the order is not processed. What should I do?

The described error is most likely caused by a mismatching public key in the test or live environment, depending on what transactions you are trying to process. Here are the steps to take and fix the issue:

  1. Let’s say you are processing test transactions.
  2. Login into “https://gatet.borica.bg/etlog”
  3. Navigate to “Borica Certificate”(Борика Сертификат) menu
  4. Copy the certificate and paste it into the “Test Public Key” setting field in the plugin settings and save.
  5. Test the payment again

Please visit the plugin changelog page for more information.