Developers

Account & Store Configuration

This guide covers issues related to setting up and configuring your myPOS store, generating API credentials, and activating terminals — the foundational steps required before any payment integration can work.

Store Registration Errors

Error during store creation

If you encounter an error when creating a new store (e.g., a currency or settlement account error), try selecting a different settlement account when specifying the currency. This resolves most registration failures.

E_STORE_RESTRICTED error

This error means the store is either disabled or the request is coming from an unapproved URL.

Check both of these:

1
Remove /checkout from Approved Links

In your myPOS store settings, the Approved Links field must contain only the root domain (e.g. https://mystore.com). Do not include paths like /checkout.

2
Ensure the store is enabled/active

A disabled store rejects all payment requests. Log in to mypos.com, go to Stores, and verify the store status. If it cannot be activated from the account, contact myPOS Support.

Error 25 — missing currency

Error 25 most commonly occurs when the required currency is not added to your store. Log in to mypos.com → Stores → select your store → Settings → add the required currency (e.g. BGN, EUR, CHF).

Each website must use its own store and credentials. Using the same configuration pack across multiple stores or domains will cause Error 25.

API Credentials & Configuration Pack

Generating credentials

Log in to mypos.com → Stores → select your store → Integration → click + New Configuration → choose Custom integration (API checkout) → select Private & Public Key.

  • Store ID and Wallet Number are static — they do not change.
  • The Configuration Pack (for WooCommerce and plugin integrations) is shown only once — save it immediately. If lost, you must generate a new one.

Regenerating keys

If you need to regenerate keys (e.g. after a plugin reinstall or key compromise):

  1. Remove the old keys from both the plugin settings and your myPOS account.
  2. Generate a new configuration in your myPOS account.
  3. Enter the new keys or configuration pack into the plugin.

After regenerating credentials, ensure you update the plugin settings completely before testing — stale keys from a previous configuration are the most common cause of signature errors after a reinstall.

URL & Domain Configuration

Store URL mismatch

The URL registered in your myPOS store settings must match exactly the domain that sends payment requests. If your website is https://shop.example.com, that domain (without paths) must be in the Approved Links field.

If the URL changes (e.g. you migrate domains), update the store URL in myPOS before processing payments.

Connecting a custom domain

  1. Log in to mypos.com → Stores → myPOS Online → select your store.
  2. Click Get a professional domain → Link it to myPOS Online.
  3. Enter your domain name.
  4. Update your DNS records with the values provided by myPOS (via your hosting provider or registrar).
  5. Save and confirm.

SSL certificate issues

If you see SSL errors for a custom domain, confirm that:

  • The domain is correctly linked to your myPOS account (see steps above).
  • DNS propagation has completed (this can take up to 24–48 hours).
  • You are using the domain registered in your myPOS account — not a subdomain or alias.

Currency Configuration

Payment requests will fail if the requested currency is not enabled in your store. To add a currency:

mypos.com → Stores → [your store] → Settings → Add Currency

Common scenarios:

  • Error 25 during a promotional campaign — a new currency (e.g. CHF) was used in a payment request but not added to the store.
  • Dual-pricing issues (BGN/EUR) — if you enable a dual-pricing plugin, ensure your integration still sends amounts in a single currency. Let the payment system handle currency display; do not modify the Amount parameter format.

Multi-Store & Token Sharing

To share tokens or payment data across stores:

  • Create a Worker Store under a Manager Store in your myPOS account.
  • Each website or application must still have its own credentials — do not share a single configuration pack across multiple domains.
  • Ensure all required currencies are added to the Worker Store.

Account Access Issues

Common access problems

Cannot log inVerify the correct country setting and birth date are entered. If these are wrong, correct them first.
Forgot password (production)Use the Forgotten Password flow at mypos.com. Temporary passwords expire within 15 minutes.
Forgot password (demo)Use the demo Forgotten Password link at merchant-demo.mypos.eu. Use birth date 1.1.2000 and country UK.
Account already exists errorUse the Forgotten Password flow instead of creating a new account.

Terminal Activation

A terminal that has not been activated cannot receive Over-The-Air (OTA) firmware or software updates.

To activate:

  1. Use the myPOS mobile app — scan the terminal's QR code or enter the serial number.
  2. Once activated and connected to the internet, the terminal can receive OTA updates automatically.
⚠️Long-inactive devices
If a terminal has been inactive for 2 or more years, its firmware may be too outdated to receive OTA updates even after activation. The device must be sent to the myPOS service center for manual software reinstallation.

Prohibited Business Types

myPOS does not support the following business types for integration:

  • Tournament entry fee collection (even if framed as gaming events)
  • Online gambling platforms
  • Cryptocurrency exchanges
  • High-risk financial services outside the EEA

Integration requests from these categories must be escalated to the Risk/Compliance team. Integration guidance cannot be provided for these business types.