Bulgaria splits into two: the bank virtual POS products, which all run on BORICA and ask for the same things, and the two independents.
myPOS
myPOS signs each request with a key you generate yourself in their portal, and you paste their certificate back so we can verify what they send.
-
1
Sign in to the myPOS portal
As the merchant.
-
2
Open your online store
The store carries the SID and is tied to the wallet the money lands in.
-
3
Generate a key pair for the store
The portal creates it and shows you the private key once, plus a key index — usually 1.
-
4
Copy the myPOS certificate too
It is published in the same section and is what verifies their replies.
| Field in TapTime | Where it comes from |
|---|---|
| Store ID (SID) | The online store in your myPOS portal. |
| Wallet number | The myPOS wallet the store pays into. |
| Key index | Shown next to the key you generated. Usually 1. |
| Merchant private key (PEM) | The key the portal generated for you. Secret, and shown once. |
| myPOS public certificate (PEM) | Published in the same section of the portal. |
ePay.bg
The simplest of the Bulgarian set: one client number and one secret word, which signs traffic in both directions.
| Field in TapTime | Where it comes from |
|---|---|
| Client number (MIN/KIN) | Your merchant number with ePay.bg. |
| Secret word | Set by you in the ePay.bg merchant settings. Secret. |
BORICA and bank virtual POS
BORICA operates the virtual POS behind most Bulgarian banks. DSK Bank and UniCredit Bulbank use it too, so all three take the same six fields — the bank issues the terminal, BORICA the keys.
-
1
Ask your bank for the virtual POS
They issue a terminal id and a merchant id, and register the merchant name exactly as it must appear.
-
2
Generate your key pair
You create a private key and a certificate request; the bank or BORICA returns the signed certificate.
-
3
Get the BORICA public certificate
Published by BORICA and needed to verify replies.
-
4
Paste all six into TapTime
Including the passphrase if your key has one.
| Field in TapTime | Where it comes from |
|---|---|
| Terminal ID | Issued by your bank with the virtual POS. |
| Merchant ID | Issued with it. |
| Merchant name | Exactly as registered with the bank — a mismatch fails the signature. |
| Merchant private key (PEM) | The key you generated. Secret. |
| Key passphrase | If you set one when generating the key. |
| BORICA public certificate (PEM) | Published by BORICA. |
DSK Bank Virtual POS
The same six fields as BORICA above, with the terminal and merchant id issued by DSK. Follow the BORICA steps with DSK's paperwork.
UniCredit Bulbank eCommerce
Again the same six fields, with UniCredit's terminal. If the bank gives you a test terminal as well as a live one, connect the test terminal first and leave test mode on until it works.
The callback address
Bank virtual POS products need the return and notification address registered with the terminal. Copy it from the provider's panel in TapTime and send it to the bank if their portal has no field for it.
Frequently asked
My bank is not listed.
If it runs on BORICA — most Bulgarian banks do — use the BORICA entry with your bank's terminal. If you are unsure, ask the bank whether their virtual POS is BORICA-operated.
How long does a bank virtual POS take to obtain?
Days to a few weeks, depending on the bank. myPOS and ePay.bg are much faster if you need to start now.
Do I need both the private key and the certificate?
You need your private key and BORICA's public certificate. The certificate the bank signs for you is registered at their end.
Thank you — that helps us make these guides better.
Write to us and quote the page you were on. A person reads every message and answers in the language you wrote in.
Write to us