OLX integration
for Medusa
OLX adverts linked to Medusa products by SKU. The plugin shows where OLX and the store disagree, reads statistics and messages, and with your consent ends, brings back and publishes adverts.
What exactly
this integration does
-
Adverts linked to variants
An advert links to a variant by its external id or by the product code line in the description. Never by title.
-
Mismatch alerts
Live on OLX but sold out in the store. Live while the product is unpublished. In stock with no advert. Four kinds of alerts with filters.
-
Advert lifecycle
The plugin ends the adverts of sold out variants and brings back the ones it ended itself when the stock returns.
-
Prices and publishing
Advert prices follow the Medusa price, and big changes wait for approval. A new advert is built from the product, with its category and required attributes.
-
Statistics and messages
Views, phone views and observers on every advert, and unread conversations linked to products.
-
Product page widget
On every product: its adverts, statistics, alerts and publishing state.
How it guards
your data
-
Plan and dry run
Every writer computes a plan and shows a dry run first. Only an armed writer writes, with a cap per run.
-
A check before every write
Before each write the plugin reads the advert from OLX again. An incomplete read removes nothing and plans nothing.
-
Encrypted tokens
OLX tokens are kept encrypted with AES-256-GCM, and in demo mode nothing reaches OLX.
Setup
in three steps
The full list of options, events and API routes is in the package README on GitHub.
Paste it into Claude Code, Cursor or another AI assistant in your Medusa project: it installs and configures the integration, with writes off.
- 1 Install the package from npm.
npm install @koda-plus/medusa-plugin-olx - 2 Add the plugin to medusa-config.ts.
plugins: [ { resolve: "@koda-plus/medusa-plugin-olx", options: { clientId: process.env.OLX_CLIENT_ID, clientSecret: process.env.OLX_CLIENT_SECRET, encryptionKey: process.env.OLX_ENCRYPTION_KEY, redirectUri: "https://api.your-store.com/olx/callback", market: "pl", // demo: true, }, }, ] - 3 Run the migrations and open the integration in the Medusa admin.
npx medusa db:migrate
Running for our clients
See our portfolio
Other
integrations
- Allegro Offers, orders, stock and parcels
- BaseLinker Cards, stock, prices and orders both ways
- Subiekt nexo Orders as ZK, WZ and invoices with KSeF
- Fakturownia Invoices, corrections and KSeF exactly once
- InPost Parcel lockers, courier and COD on ShipX
- Stripe Volume, fees, disputes and account health
- Negotiations Target price, counter offer, acceptance
- Trade credit Limits, terms and customer balances
- Loyalty Points, a reward ladder and a ledger
- Packaging Piece, box, pallet, minimum and step
- EU compliance GPSR, RODO and Omnibus in one panel
- VAT whitelist NIP, VIES and REGON in one panel
- E-mails Ready templates in Polish and English
- Tasks Tasks on orders, products and customers
Tell us about your project,
we'll tailor the rest to you
A 15-minute call is enough for us to know whether we are a fit for your project.
We start from what you need, not from an off-the-shelf solution.