Before you start
- A myPOS business account (merchant.mypos.com).
- A published property site — see the guide to the guest guide and site.
- Step 1
Create an online store in myPOS
In myPOS open Stores (Магазини) and create an online store for the property. Choose “Hotels and tourism” as the business sector and “Accommodation” as the business activity.
Under Website address (Уебсайт адрес) enter your property site's address, e.g. https://smarthoster-bg.com/site/your-property. That's the page myPOS checks: what you sell, your contacts and terms.
Simplified illustration of myPOS — the real screen may look slightly different. - Step 2
Add https://smarthoster-bg.com to the approved links
In the same store Settings, press + next to Approved links (Одобрени линкове) and add exactly https://smarthoster-bg.com. The guest goes to myPOS from their stay page on smarthoster-bg.com, and myPOS only takes payments from approved addresses.
The address is the same for every host — that's fine, because each store has its own keys and the money always goes to the store whose configuration pack you entered.
Simplified illustration of myPOS — the real screen may look slightly different. Without this link, when a guest presses “Pay … by card”, myPOS shows an error that the gateway isn't configured correctly.
- Step 3
Enter the configuration pack
In myPOS open the store's Integration (Интеграция) tab and copy the configuration pack. In Smarthoster-bg open Settings → “Online payments (myPOS)”, paste it and press “Save configuration pack”.
The pack holds your store's keys, so it's stored encrypted and never shown again — you only see the store number.
Simplified illustration of Smarthoster-bg — the real screen may look slightly different. - Step 4
Fill in your Наредба Н-18 details
Under Settings → “НАП — Наредба Н-18” choose how you rent out: “Private landlord (natural person, not a trader)” or “Company or sole trader (ЕООД, ООД, ЕТ…)”. A company also fills in its seller and НАП e-shop details — each payment then gets a sale document, and the monthly НАП file is on the Export page. Real payments aren't possible without these details.
Also fill in “Contacts on your sites” in Settings and “Terms & policies” in the property's guide — myPOS looks for them on your site.
Check with your accountant which applies to you.
- Step 5
Switch payments on and confirm a booking
Tick “Take online payment for direct bookings”. When you confirm a request from your site, “Total price (€)” is the amount the guest pays by card.
The “Pay … by card” button on the stay page opens from the day before check-in (you can change that in Settings) and the guest is emailed the link. If they still haven't paid on check-in day, you're emailed.
- Step 6
Check that it works
Make a request on your site with your own email, confirm it and press “Pay … by card” on the stay page. If myPOS's card form opens with your name and the amount, everything is set up — you can close the page without paying.
For a full test with no real money, use “Test mode” with a test store and configuration pack from myPOS's sandbox.
Questions about this step
Does the money go through Smarthoster-bg?
No. The guest pays on your myPOS store's page and the money goes straight to your account. Card details never reach us.
How do I refund a payment?
Refund the amount in your myPOS account, then on Bookings press “Record refund” on the reservation. Only then can a paid reservation be cancelled with “Cancel reservation”. The refund goes into the monthly НАП file.
Can a guest pay twice?
No. Each reservation has one myPOS order — once it's paid, the “Pay … by card” button disappears.