In order to accept payments by debit or credit cards, you need to sign a contract for virtual POS terminal with one of BORICA partners:
Allianz Bank Bulgaria
BORICA PI (for government organizations only)
Bulgarian American Credit Bank
Central Cooperative Bank
Datecs Payment Technology
Eurobank Bulgaria (Postbank)
International Asset Bank
Investbank
Municipal Bank
ProCredit Bank (Bulgaria)
Texim Bank
Transcard Financial Services
UniCredit Bulbank
United Bulgarian Bank (KBC Group Bulgaria)
Downloading and Activation
1. Sign in to your WordPress site as an administrator
2. From your WordPress dashboard go to Plugins > Add New
3. Search for BORICA Payments
4. Click on 'Install Now' button to install BORICA Payments
5. Activate the plugin by clicking on 'Activate Plugin'
6. Once the plugin is activated it is visible under menu Installed Plugins
Your virtual POS may operate in BGN, EUR or USD according to the contract with your bank. Select respective currency in “Currency options” from WooCommerce > Settings > General tab
In WooCommerce > Settings > Payments tab mark needed checkboxes and fill in the fields. Make sure the parameters are correct:
| Enable/Disable: | When checkbox is marked, BORICA Payments is enabled |
| Debugging: | When checkbox is marked, BORICA Payments is in debug mode |
| Test Mode: | When checkbox is marked, BORICA Payments works in test environment |
| BACKREF: | Merchant URL for posting authorization result. Send this URL to your bank/BORICA |
| Terminal Identifier (TID): | ID of the terminal, provided by your bank/BORICA |
| Merchant Identifier (MID): | Your Merchant ID, provided by your bank/BORICA |
| Merchant name: | Your customers will see this in their statement to identify the payment |
Save changes.
To generate Private Key and Certificate Signing Request (CSR) for test and production environments, you could use
Private Key and Certificate Request Generation link in the Help section of the Plugin. After filling the form, press "GENERATE AND DOWNLOAD” button.
Please note that the keys for test and production environments are different and must be loaded accordingly. It is recommended to protect the Private Key for production environment with a password.
It is important not to share the Private Key with anyone and store it securely.
Save changes.
These options allow you to customize the behavior and appearance of the BORICA Payments plugin within WooCommerce.
| Direct payment | Yes / No— Enables or disables the Direct Payment Mode in BORICA Payments. When enabled, customers are redirected directly to the BORICA payment page to complete their payment using a credit or debit card. If disabled, additional confirmation is required. |
| Show payment response | with order details / without order details — Defines what information is displayed to the customer after the payment is processed.
- with order details – shows payment confirmation together with order summary and details.
- without order details – displays only the transaction status without showing the order contents.
|
| Use theme landing page settings | Yes / custom theme settings — Defines how the payment response page is displayed to the customer after completing or cancelling a transaction.
- Yes – uses the default BORICA layout and style for the payment response page.
- Use custom theme settings – applies your WordPress theme’s custom layout, colors, and typography to the payment response page for consistent branding.
|
| Default payment page language | Select the default language for the BORICA payment page displayed to customers.
|
Recurring Payments allow merchants to automatically charge customers a fixed amount at regular intervals (for example, monthly subscriptions, memberships, or installment plans). The feature is managed by BORICA’s secure payment gateway using the EMV 3-D Secure protocol.
Once the customer completes an initial authenticated payment, and consents with recurring plan creation, BORICA’s gateway (APGW) generates and securely stores a token linked to the card. All subsequent payments are automatically executed by BORICA’s system according to the predefined schedule — without requiring the customer to approve subsequent payments or to involve the merchant.
Recurring Payments are available for merchants whose contracts with the Acquiring Institutions explicitly include this functionality.
Specific settings for Recurring Plan:
| Enable Recurring Payments Yes/No | Enables/Disables recurring payments mode |
| Show button to close a recurring plan Yes/No | Enables/Disables a button to close the recurring plan for selected order on the order review page |
Configuring Recurring Plans
| Enter name | The internal name of the recurring plan. |
| Duration | The total duration of the recurring plan — how long it will remain active. Enter a numeric value representing the total number of periods. |
| Duration unit | The time unit for the plan duration. Available options: day, month, quarter, half-year, year.
Example: Duration = 12 and Duration unit = month means the plan will run for 12 months. |
| Frequency | Frequency of execution of subsequent payments: number of periods between authorizations . |
| Frequency unit | The unit of time between payments. Available options: day, month, quarter, half-year, year.
Example: Frequency = 1 and Frequency unit = month means the customer is charged once per month |
| Mday payment | (Applicable only when Frequency unit = month) The specific day of the month on which the recurring payment should be executed — a number between 1 and 31.
If set to 31, payments are scheduled on the last calendar day of each month.
|
| Save | |
Setting plans for your products – Once a Recurring Plan is created, you might assign it to specific products. A Recurring Plan could be assigned to multiple products, and one product could have more than one Recurring Plan assigned. If a recurring Plan is not assigned to any product, it is configured, but not in use.
- Open your product for editing in the WordPress Admin panel.
- In the Product Data section, locate the Recurring Payments field.
- From the dropdown list, select the desired Recurring Plan you previously created.
- Click Update to save your changes.
Initial Payment and Recurring Scheduling at BORICA’s Payment Gateway
When a customer purchases a product that uses a Recurring Payment Plan, BORICA payment gateway automatically handles both the initial payment and the scheduling of future recurring charges.
- Initial Payment – The customer completes the first payment through the BORICA payment page.
This transaction amount is determined by the product price and the parameters defined in the selected recurring plan.
- Recurring Scheduling – Once the initial payment is successfully authorized, BORICA’s system automatically creates a recurring payment schedule according to the plan settings (frequency, duration, and payment day).
Each subsequent charge is processed automatically by BORICA without requiring further customer input.
Example:
If the product price is 120 EUR and the selected recurring plan is monthly for one year, the system divides the total amount into 12 equal monthly payments of 10 EUR.
The first payment (10 EUR) is processed immediately, and the remaining 11 payments are scheduled — one per month — until the plan expires.
If the price of the product is not divisible into equal subsequent payments, information of the number and sum of payments is visualized on the confirmation page.
Viewing and Managing Recurring Plans
In the
WordPress order details, you can find information about the
initial payment that created the recurring plan.
Refunds are available
only for the first transaction of the plan.
If a refund is processed
before the next scheduled payment, the recurring plan is automatically
closed.
All
subsequent recurring payments are executed automatically by BORICA’s payment gateway and can be
monitored in the Merchant Portal.
In the Merchant Portal, you can view detailed information such as:
- Payment amount and currency
- Frequency and duration of the plan
- Current plan status
- Next and last payment dates
The merchant can manually close the plan at any time by clicking Close button.
Cancelling Recurring Plans
A recurring plan can be closed in the following cases:
- Automatically, when its validity period expires
.
- Manually, via the Close button in the Merchant Portal.
- Automatically, if the virtual POS terminal is deactivated.
- Automatically, upon receiving specific response codes from the issuer (e.g. invalid or expired card).
- By customer request, initiated from the user’s account in your online store (if you provide such an option to the customers).
- BORICA Payments supports English and Bulgarian languages. In order to use the Bulgarian version, Site language must be set accordingly in WooCommerce. Translating methods are described here.
- Be sure you receive orders in proper time. Verify time and Timezone following the instructions here.
When receiving orders in your shop, sometimes you may have to refund your customers. When you press the "Refund" button in the order details, two options appear:
- For manual refund of the amount you have to refund the amount via bank transfer or other agreed method.
- To refund via payment system using BORICA Payments. The system generates an operation to send the funds to the card. You may reverse the full purchase amount, or part of it. This option is available for 30 days after the purchase.
If you have any questions, need further support or just want to leave your feedback, please do not hesitate to contact us at:
e-comPlugins@borica.bg