Balikobot Shipping App

Description

For the shipping methods your Balikobot Portal marks as pickup-point methods, this plugin shows a
pickup point picker at checkout. The customer chooses a point on a map, and the chosen point is saved
on the order for Balikobot to read.

Both WooCommerce checkout implementations are supported:

• The classic shortcode checkout ([woocommerce_checkout])
• The Checkout block (woocommerce/checkout)

Nothing has to be copied into the shop by hand. The plugin asks the Balikobot Portal which widget
belongs to this shop, matched on the shop’s own web address, and which shipping methods offer a
pickup point. No Balikobot credential is stored here. The only setting is whether the map opens in a
dialog or is shown directly in the checkout.

Balikobot is a paid shipping service. The plugin does nothing until you have a Balikobot account with
this shop connected in the Balikobot Portal.

Source code

The Checkout block script in blocks/build/ is compiled from blocks/src/, which ships with the
plugin. To rebuild it, run npm install && npm run build in the blocks/ directory.

External services

This plugin connects to services operated by Balikobot s.r.o. (https://www.balikobot.cz/). Without
them there is no pickup point picker.

Balikobot widget host

The widget files are hosted by Balikobot on Google Cloud Storage, under
https://storage.googleapis.com/bb-dist-prod/widget/. Google only hosts the files: Google Cloud
terms https://cloud.google.com/terms, Google Cloud privacy notice
https://cloud.google.com/terms/cloud-privacy-notice.

• Your server downloads widget/v1/config.json, which names the Balikobot Portal API address,
  before it calls the Portal API (see below). The request carries only WordPress’s standard user
  agent, which includes the site address.
• The customer’s browser loads the widget script widget/v1/balikobot-widget.js on the checkout
  page. When the customer opens the picker, the browser also loads the picker page, the map tiles
  (OpenStreetMap data) and the street search index from the same host. The picker page address
  carries the widget id, the shop’s web address and the checkout language. Like any web request,
  these requests reveal the customer’s IP address and browser to the host.

Balikobot Portal API

The Portal API (https://portal-api.balikobot.com) tells the plugin which widget belongs to the shop
and returns the pickup points.

• Your server calls GET /api/widgets/resolve and GET /api/widgets/{id}/config to learn which
  widget belongs to this shop and which shipping methods offer a pickup point. Both requests send
  this shop’s web address (the Site Address from Settings > General) and nothing else. They run when
  the cart or checkout page loads, when an order is placed, and on the Balikobot settings screen.
• When the customer opens the picker, their browser requests the pickup points and their details.
  These requests send the widget id, the shop’s web address, the destination country and the name
  of the chosen shipping method, along with the customer’s IP address like any web request. They send no cookies and no customer name, address or contact details.
• If the customer allows it, the browser’s location is used to centre the map. It stays in the
  browser and is not sent.

The pickup point the customer picks is posted back to your shop and saved on the order.

Terms of use: https://www.balikobot.cz/wp-content/uploads/2026/08/Vseobecne-obchodni-podminky-2026_EN.pdf
Privacy policy: https://www.balikobot.cz/wp-content/uploads/2026/08/Zasady-ochrany-osobnich-udaju-Balikobot-s.%E2%80%85r.%E2%80%85o._CZ.pdf
All legal documents: https://www.balikobot.cz/dokumenty/