FAQ

For merchants

What does the plugin cost?

Nothing. It is free and open source (Apache-2.0). You pay Shipbubble for each booked shipment, from your own Shipbubble wallet.

Does Shipbubble charge for checking addresses?

Yes. Shipbubble validates every new delivery address, and after the 50 free validations on a new account each successful one costs ₦5 from your wallet. The plugin stores each address's result for good, so the same address is never paid for twice; sandbox and live are counted separately.

Who pays the courier?

You do, from your Shipbubble wallet, when the shipment is booked. The customer pays you the shipping price shown at checkout. The plugin never collects or relays delivery fees.

Can I charge more than the courier price?

Yes. Set a Markup — a fixed amount or a percentage — under Checkout price. The order card shows both what the customer paid and what Shipbubble charges.

Do I need a Shipbubble account?

Yes, with API keys (app.shipbubble.com). Start in sandbox mode with the sandbox key; no real shipments are booked.

Which currencies are supported?

NGN only. Shipbubble quotes in naira; in any other currency the method tells the customer it isn't available.

Can customers choose the courier?

Yes. Every courier that delivers to the address is listed with its delivery estimate and price, cheapest first and preselected. You can limit the list under Couriers offered at checkout.

Why must customers enter a phone number?

Couriers need it to deliver. Without one the method asks the customer to complete the address. Turn on the phone field under Settings → Shop → Login & sign-up.

What if a product has no weight?

It is priced with the Default product weight (0.5 kg unless you change it). The configuration page warns how many active products have no weight, so add the real ones.

Are product dimensions used?

No. The parcel is sized by weight: the first standard Shipbubble box that carries it, otherwise your default box.

What happens if Shipbubble is down during checkout?

With a fallback price, customers can still order courier delivery at that price, and you book the courier from the order later at the real price. Without one, customers choose another shipping method. Checkout never breaks.

When is the courier booked?

When the order is paid — the installed flow Shipbubble: create shipment when paid does it. You can switch that flow off and book each order yourself with Create shipment.

Why am I asked to confirm a new price?

A checkout quote can be booked once and expires. Shipbubble keeps a quote bookable for seven days. If it's older than six days, was rejected, or the order was placed at the fallback price, the plugin fetches a new price and asks you to confirm it. The customer's price never changes.

Can I cancel a shipment?

You can ask Shipbubble to, with Cancel shipment while the parcel isn't delivered. Before pickup, Shipbubble refunds the label to your wallet minus a ₦150 cancellation fee. After pickup it can't be cancelled; Shipbubble's reason is shown on the order.

Is cash on delivery supported?

Not through Shipbubble in this version. Your shop's other payment methods work as usual with courier delivery.

Can I ship from several warehouses?

Not yet. Each sales channel has one pickup address (the sender in the settings).

How does the customer track the parcel?

The Shipbubble order id becomes the order's tracking code and links to Shipbubble's tracking page — in the tracking email, in Shopware's shipping emails and in Account → Orders.

Do I need to set up flows or a webhook secret?

No flows: five are installed and active. No webhook secret either: paste the webhook URL from the settings page into the Shipbubble dashboard; updates are verified with your API key.

Why doesn't the delivery status say "delivered"?

Shopware has no delivered delivery state. The delivery stays Shipped, the Shipbubble card says Delivered and the customer gets the delivered email.

Do I need a message queue worker?

Yes. Shipbubble's status updates are processed in the background. Without a worker they are stored but not applied.

Can I text customers instead of emailing them?

Yes. Use the Shipbubble triggers in your own flows with an SMS or messaging action, for example the SMS plugin's Send SMS.

Does it work on Shopware 6.6?

No. Shopware 6.7 only.