Developers

myPOS + HotelRunner: Easy Integration Guide

Welcome! This guide will help you quickly connect your myPOS account to your HotelRunner Booking Engine so you can start accepting online payments for hotel reservations.

What You'll Do

  1. Create a myPOS Checkout Store for your hotel.
  2. Generate 5 required parameters for HotelRunner.
  3. Enter these parameters into your HotelRunner account.

What You Need for HotelRunner

You'll need to collect these 5 items from myPOS:

  1. Private Key
  2. Public Certificate
  3. Key Index
  4. Store ID
  5. Client Number

Step-by-Step: Connect myPOS to HotelRunner

1. Create a New Checkout Store

  1. Log in to your myPOS account.
  2. Go to Stores.
  3. Click Create Store and follow the instructions.
Create Store in myPOS

2. Choose Integration Method

During store creation, select myPOS Checkout API as your integration method.

Choose myPOS Checkout API Integration Enter Store Details

3. Set Up Currencies

Important: Make sure the currency you select matches your HotelRunner reservation currency.

  • Accept bookings in EUR? Enable EUR.
  • Want to accept BGN, GBP, or others? Create accounts for each currency.

You can change currencies later: Stores > eCommerce > [Your Checkout] > Settings > Transaction currencies

4. Generate Your Keys

  1. Go to the Integration tab.
  2. Click to generate your key pair.
  3. Save your Private Key somewhere safe (you'll only see it once!).
  4. Download your Public Certificate (you can re-download this later).
Generate Public and Private Key Pair

Lost your Private Key? You'll need to generate a new key pair.

Delete Key

5. Find the Key Index

In the Integration tab, look for the Key Index (bottom left of the screen). This number identifies your key pair.

Key Index

You'll need to give this Key Index to HotelRunner.

6. Get Your Store ID and Client Number

  • Store ID (SID):

    • Find this in the general information section of your Checkout.
    Store ID

  • Client Number:

    • Find this under Company Information (top-right corner of your myPOS account).
    Client Number

Quick Reference Table

ParameterWhere to Find It
Private KeyIntegration tab (generated once)
Public CertificateIntegration tab
Key IndexIntegration tab
Store IDCheckout > General Information
Client NumberAccount > Company Information

Add Details to HotelRunner

Once you have all 5 parameters:

  1. Log in to your HotelRunner account.
  2. Go to Payment Settings > myPOS.
  3. Enter each parameter in the correct field.

HotelRunner will start using myPOS for payments as soon as you fill in all fields correctly.

myPOS Store Verification

  • After setup, myPOS will review your Checkout.
  • This can take up to 5 business days.
  • You may be asked for extra documents.
  • Any changes to your setup will require re-verification.

Once approved, myPOS Checkout will show up as a payment option in your HotelRunner booking module.

Request URL Format

Your request URLs must look like this:

CorrectIncorrect
https://YOUR_HOTEL_NAME.hotelrunner.com/URLs with ports or subfolders

Need Help?

Exely Support:
📧 support@exely.bg

myPOS Support:
📧 integrations@mypos.com

All Done!

You’re now ready to securely accept online reservations using myPOS and HotelRunner.