Selling on Biklo from CS-Cart - step by step

Biklo for CS-Cart lists your shop's products on Biklo, keeps stock and prices in step, and brings Biklo orders into CS-Cart, where you accept and ship them. This guide takes you from installing the add-on to your first order and your first payout.

You need: a Biklo company account, CS-Cart Ultimate 4.16 or later (with the Product variations add-on, which is on by default), and a shop in the same currency as your Biklo account.

Start with a sandbox key (bk_test_…). The sandbox is a copy of Biklo where nothing is real - no buyers, no payments, no courier. You can try everything below, including orders, before you switch to a live key.

#1. Install the add-on

1. Add-ons → Manage add-ons → the gear button (top right) → Manual installation → choose biklo-cscart.zip → Upload & install.
2. Biklo appears among your add-ons, active.

The Biklo screens are under Marketing → Biklo.

Every Biklo screen has the same header: which Biklo you are connected to (Sandbox or Live), Get help, and the setup steps in order - Connect, Categories, Brands, Readiness, Sync, Payouts.

Background work. The add-on sends your products and fetches orders in the background. CS-Cart has no scheduler of its own, so ask your host to call the cron address shown on Biklo → Sync every minute. Without it the shop starts the work itself while someone uses the admin or the storefront - fine for a busy shop, slow for a quiet one. Biklo → Sync says which one your shop uses.

#2. Connect your Biklo account

1. On biklo.ro: My account → API integrations → New integration. Copy the bk_test_… key (the sandbox) - or bk_live_… when you go live.
2. In CS-Cart: Marketing → Biklo (Connect), paste the key in API key, then Test connection.
3. You should see Connected as …, Sandbox and All required permissions granted. Save changes.

The key is stored encrypted and never shown again - only its last four characters.

#What is set on your Biklo account

Below the connection, the add-on shows what you set on Biklo itself - not here - because it applies to everything you sell on Biklo: who pays delivery (in your country and abroad), Biklo's service fee, price offers, where the courier collects, the countries you sell to, and your payouts. Each card says what it means and links to the page on Biklo where you change it.

#Orders from Biklo (the webhook)

Biklo tells your shop about new orders the moment they happen, at the address shown here. Leave The add-on, automatically - it is set up for you when the sync starts. Without it, orders still arrive, checked every 10 minutes.

Order statuses: a Biklo order arrives as Paid (stock taken), becomes Complete when the courier delivers, Canceled if it is rejected, and Refunded on Biklo when everything came back (the add-on creates that status). Choose other statuses here if your shop uses its own.

Returns: whatever Biklo refunds on a return is recorded on the order. Untick Put returned pieces back into stock if you want to check returned items before they go back on sale. See Returns.

#3. Map your categories

Biklo needs a Biklo category for every product. Biklo → Categories: choose the closest Biklo category for each of yours. Suggestions are pre-filled (check and save); a subcategory left empty uses its parent's choice; choose Don't sell this category on Biklo for things like gift cards. Save changes.

#4. Map your brands

Biklo → Brands. Choose where your brands come from (CS-Cart's Brand feature, or another product feature). Your brands are matched to Biklo's by name; a column appears only for the Biklo brand lists your products need. A brand Biklo does not know is listed as Altă Marcă - or held back until you choose one, if you prefer.

#5. Check readiness

Biklo → Readiness checks every product against Biklo's rules before anything is sent, and says exactly what to fix: a title too short or too long (Biklo counts bytes: ă, ș, ț count twice), a missing description, a category not mapped…

#Sizes and colours

• Variations (Products → a product → Variations) are listed one per variation, each with its own stock and price, and shown on Biklo as one product with a picker - also when the group has several features (size and colour). When you add, detach or move a variation in CS-Cart, Biklo's picker follows.

• Options the buyer chooses (Products → a product → Options) stay one listing with the product's whole stock: CS-Cart keeps no stock per option, so there is no honest number for "size M". Readiness says so. Make them variations to sell each one separately.

#The product's Biklo tab

Every product has a Biklo tab: keep a product off Biklo, give it a Biklo-only title (with a byte counter), a condition, or a different Biklo category - and see right away whether it is ready and where it is on Biklo. It is saved with the product (Save). On a variation, the tab points to the group's first product, where these settings are.

#6. Start the sync

Biklo → Sync → Start syncing. Ready products go to Biklo in the background, with their images. From then on only changes are sent: stock and price as they change (also after an order in your shop), everything else when you edit a product. A product you disable or delete is taken off Biklo, and put back when it returns.

The checks must be green - connected, permissions, a shipping address on Biklo, and the shop's currency matching your Biklo account:

Activity says, in plain words, everything the sync did:

In the sandbox, try an order without a buyer: Biklo → Sync → Sandbox: try an order creates one from a made-up buyer.

#7. A Biklo order arrives

It appears in Orders → Orders, already Paid (payment Paid on Biklo, shipping Delivered by Biklo at 0), with the stock taken. The Biklo column says what to do next.

Open it. The Biklo box at the top of the order is where you handle it. The Biklo reference is also in the order's staff notes, and Biklo history lists everything that happened to the order on Biklo.

Biklo emails the buyer - CS-Cart's own customer emails are off for Biklo orders.

#8. Accept it - and check before the courier is booked

Review and accept… opens the last check before Biklo books its courier:

1. What you send - lower a product if you are short, even to 0. Biklo refunds the buyer what you do not send.
2. Packing (with several products) - everything in one box, or one box per product.
3. Ships from - your address on Biklo or one of your pickup points, with the exact name, phone and email the courier gets. Change it on Biklo if something is wrong.
4. The summary shows what ships and what the buyer gets back.

Tick I checked the address and the phone → Accept and book the courier.

The courier is booked: print the Label (PDF) (or ZPL), stick it on the parcel and hand it to the courier. You can also send Biklo a link to your invoice for the buyer.

Tracking shows the parcel's journey right there, without leaving the order:

When the courier delivers, the CS-Cart order becomes Complete.

Returns. If the buyer sends something back, Biklo holds the money meanwhile. When the parcel is back with you, the Biklo box shows Back with you and Decide by … (48 hours), and the orders list says To do: check the returned product. Check it, then Accept the return (Biklo refunds the buyer) or Reject the return, saying what is wrong (the Biklo team decides). Whatever happens is recorded on the order as it happened. Every case, step by step, with pictures: Returns.

Cannot send it at all? Reject - Biklo refunds the buyer, and CS-Cart puts the stock back.

Changing a Biklo order's status by hand: untick Notify customer - Biklo already tells the buyer.

#9. Get paid

Biklo → Payouts. Biklo collects the buyer's payment and pays you after delivery, once the return window closes. The first time, finish your payout account on Biklo (a one-time identity check by Stripe, done in your browser): the card says exactly what is missing.

Then your balance shows what is available; Withdraw sends it to your bank.

#10. Going live

When everything works in the sandbox: create the live key on Biklo (bk_live_…), paste it in Marketing → Biklo, save, and start the sync. Your products are listed on the real marketplace.

#Need help?

Get help is on every Biklo screen. Describe the problem: the add-on adds what our support needs - versions, settings, the sync and order state, recent errors, never your keys - and you can read it first. You get a reference, and we answer by email.

The screenshots are generated from the add-on itself (dirtbike-integrations-dev/e2e/cscart/tutorial.spec.ts, E2E_TUTORIAL=1), so they can be refreshed whenever a screen changes.