Tender POSTender POS

Connect Medusa to Tender POS

About the Medusa integration

On this page

Connect your Medusa backend so Tender POS can keep a fast local copy of your locations, catalog, inventory, customers, discounts, and orders.

Before you start

  • A public Medusa v2 backend and access to its Admin dashboard. If you don't have one yet, share our backend setup guide with the developer who'll be setting it up.
  • Permission to create a secret API key and deploy the small Tender POS subscriber module in your Medusa application.
  • Time required: about 10–15 minutes.

What you'll need

Field Where to find it What it's for
Medusa API URL Your hosting dashboard → the Medusa backend service → Networking or Domains → copy its public HTTPS URL Tells Tender POS which Medusa store to connect to
Admin API token Medusa Admin → Settings → API Key Management → Secret Keys → create a secret key and copy it Lets Tender POS securely read your store data and create supported updates
Webhook signing secret Generate a new, strong random value; save it as POS_WEBHOOK_SECRET in your Medusa backend as described below Lets Tender POS verify that live updates really came from your Medusa app

The webhook signing secret is not a value Medusa creates for you. Generate it once, then enter the exact same value in Tender POS and in your Medusa backend's POS_WEBHOOK_SECRET environment variable. Keep it private.

Steps

  1. Ask the developer who maintains your Medusa backend to install the Tender POS webhook subscriber. They must set:
    • POS_WEBHOOK_URL to https://api.tenderpos.io/webhooks/commerce/medusa
    • POS_WEBHOOK_SECRET to the webhook signing secret you generated above
  2. Deploy or restart the Medusa backend so the new subscribers load.
  3. In Tender POS, go to Settings → Integrations → Medusa.
  4. Enter the Medusa API URL, Admin API token, and Webhook signing secret, then click Connect. Tender POS checks the credentials immediately and explains anything that needs fixing.
  5. Once the card shows Connected, click Start full sync and leave the page open to watch its progress.

What happens after you connect

  • Tender POS imports your locations, products, variants, prices, inventory, customers, discounts, and orders into its local mirror.
  • Product, variant, inventory, order, and customer changes stream in automatically through the installed subscriber.
  • Discount changes currently update on the next full sync rather than by webhook.
  • To confirm it worked, check that the Medusa card says Connected, the full sync completes, and a product from Medusa can be found at the register.
  • Something off? Email support@tenderpos.io and we'll take a look.