↑↓ selectEnter openEsc close

    1. Elbuz

    How to connect Paysera Delivery in your store

    6 min readUpdated

    Paysera Delivery ships to Lithuania, Latvia and Estonia under one Paysera contract. Parcel lockers: Omniva, LP Express, SmartPosti, UNISEND; couriers: Omniva, LP Express, Venipak, SmartPosti. The store shows Paysera's parcel price and creates Paysera shipments itself.

    When you need this:

    • You sell to the Baltics — the customer picks an Omniva parcel locker or courier and sees their cart's delivery price.
    • No manual parcel entry — the Paysera shipment is created when the order gets the selected status.
    • You cover delivery above a set total — “Free from” makes delivery free for the customer.

    Where to start: “Store settings” → “Delivery” → “Delivery” card → “Baltics · Paysera Delivery” block.

    What Paysera Delivery can do

    How to connect Paysera Delivery

    You need a delivery contract with Paysera and a delivery project in your Paysera account. In the project, turn on the couriers you need and save the sender addresses — the warehouses parcels are collected from.

    1. Open the delivery screen. “Store settings” → the “Delivery” section → the “Delivery” card.
    2. Turn on Paysera in the “Carriers” block. A Ukrainian store doesn't see the Baltic carriers: first click the “… more: Poland, Other countries, Baltics” chip above the list, then the circle in the “Paysera Delivery” row. How the list works is explained in “How to set up delivery in your store”.
    3. Enter the keys in the “Baltics · Paysera Delivery” block: “Paysera project ID” (digits only) and “Project password”. The password field is visible only when Paysera is on. Both are in your Paysera account → Delivery → project settings.
    4. Check “Countries”. By default — Lithuania, Latvia and Estonia. Nothing selected also means all three.
    5. Choose the “Sender address” (below) and the status for shipments (below).
    6. Click “Save”.
    The Carriers list with the Paysera Delivery row at the bottom
    1Paysera Delivery
    2Carrier switch
    3Baltics
    1. Click the name to open the Paysera settings.
    2. Turns Paysera Delivery on at checkout once saved.
    3. The carrier's region: Baltic carriers appear after the “more” chip above the list.
    The Paysera Delivery connection block with the Enabled switch on
    1Enabled
    2Paysera project ID
    3Project password
    4Countries
    1. Shows Paysera options to customers; without it the password field is hidden.
    2. The delivery project number from your Paysera account, digits only.
    3. The password of the same project; after saving only a “set” mark is shown.
    4. Countries of the delivery address for which options are shown and parcel lockers are loaded.

    Without the ID or password, Paysera can't be saved as on. After saving, the password isn't shown — you only see that it is set. How the window works in general is in “Store settings”.

    The store loads parcel lockers once a day: only for the couriers turned on in your Paysera project and only for the selected countries. After you first connect, the parcel lockers appear at checkout within a day.

    Can I use the keys from Paysera payments?

    No, these are separate fields. Delivery uses only the keys from the “Baltics · Paysera Delivery” block, and the Paysera payment module uses its own, from its own screen.

    If you accept both payments and delivery through Paysera, enter keys on both screens: for delivery — the keys of the delivery project. About payments: “How to accept Paysera payments in your store”.

    Where parcels ship from: the sender address

    The Paysera price depends on the sender address. It is set in the “Baltics · Paysera Delivery — sender” block.

    The Paysera Delivery sender block
    1Sender address
    2Refresh from store
    3Sender city
    4Sender postcode
    5Sender street
    1. A warehouse saved in your Paysera account; the manual option uses the fields below.
    2. Pulls in the addresses you just saved in your Paysera account.
    3. The city parcels leave from; the price depends on it.
    4. The postcode of this address, for example LT-01100.
    5. Leave empty to use the first line of the store address.
    “Sender address”Address used for the priceSender in Paysera
    A saved address from your Paysera accountThe selected addressThe selected address
    “Enter it by hand below”“Sender city”, “Sender postcode”, “Sender street”The sender set in your Paysera project

    Choose a saved address: then the price and the shipment come from the same warehouse. With a manual address, keep it the same as in your Paysera project, otherwise the price on the site won't match the Paysera bill.

    • The store takes the address list from Paysera: a few minutes after you save the keys, and then once a day. If the address is already saved in Paysera but isn't in the field, click “Refresh from store” under the field. If there are unsaved changes, click “Save” first.
    • If there are no saved addresses yet, the field shows “No saved addresses in your Paysera account yet — the address below is used.”
    • The manual address fields are visible only while “Enter it by hand below” is selected. If “Sender street” is empty, the first line of the store address is used. The name, phone, e-mail and country come from the store settings.
    • If the selected address is deleted in Paysera, the store calculates the price from the manual address.

    No address selected and no city or postcode — “Still to set up” on the right shows “Paysera: no sender — choose a warehouse or enter the city and postcode”.

    What price the customer sees

    Paysera gives the price of each option based on the sender address, the customer's country, city and postcode, and the parcels in the cart. Paysera quotes without VAT, and the store adds your percentages:

    price = Paysera rate × (1 + “VAT on the price, %”) × (1 + “Markup, %”) + “Markup, fixed”

    These fields are in the “Baltics · Paysera Delivery — price” block. By default VAT is 21% and there are no markups. The rate is converted to the store currency; the fixed markup is in the store currency and is the same for all Paysera options.

    What happened (checked in this order)What the customer sees
    The cart is heavier than the option's “Up to, kg”No option
    Paysera gave no price (no response within 5 seconds, or it doesn't ship this option), fallback price is 0No option
    The product total reached the option's “Free from”“Free” — you pay for delivery
    Paysera gave a priceThe price from the formula
    Paysera gave no price, fallback price is above 0The fallback price

    The fallback price is the “Price” column in the Paysera rows of the “Prices and options” block, with the “Fallback price” caption under the field. “Free from” and “Up to, kg” are there too.

    For parcel lockers, “Up to, kg” is 30 by default. The store doesn't check the parcel locker compartment size: don't offer bulky items for parcel locker delivery.

    The Paysera Delivery group in the prices and options table
    1Omniva parcel locker row
    2Fallback price
    3Free from
    4Up to, kg
    1. A separate option for every courier and delivery type.
    2. The price used when Paysera does not answer; 0 hides the option.
    3. The cart total from which delivery is free.
    4. A heavier cart no longer shows this option.

    The store remembers Paysera's response for up to an hour for the same address and cart, so checkout doesn't wait. A failed response is remembered for 10 minutes: during that time the fallback price applies.

    How the store counts parcels

    • By default — a separate parcel for each product unit. “One parcel per order” — all products in one parcel with the total weight, in the size set in your Paysera project.
    • Weight and dimensions come from the product card. If no weight is set, “Weight of a product with no weight set, kg” is used, 1 kg by default.
    • “How you hand parcels over” — “A courier picks them up” or “I drop them at a parcel terminal”. The store takes the price for exactly this option, if Paysera gives it.

    The Paysera bill may differ from the price on the site: box size, surcharges. Build the difference into the markup.

    What the customer sees at checkout

    Paysera options appear only when the delivery address country is among the selected “Countries”. Each courier is a separate option with its own price: “Omniva: parcel locker”, “LP Express: courier”, “Venipak: courier”. Set your own name in the “Title for the buyer” column.

    OptionWhat the customer enters
    Parcel locker (Omniva, LP Express, SmartPosti, UNISEND)The city with suggestions, then this courier's parcel locker by street, code or place. No postcode needed
    Courier (Omniva, LP Express, Venipak, SmartPosti)Street, “House” (required), “Flat” and postcode (required)

    Paysera Delivery has no cash on delivery. A customer who picked a Paysera option sees “The picked point does not take payment on pickup” next to cash on delivery.

    How shipments are created in Paysera

    The store creates the shipment in Paysera itself when an order with a Paysera option gets the status from the “Create the shipment at order status” field. By default it's “Do not create” — no shipments. The fields are in the “Baltics · Paysera Delivery — shipments” block.

    The Paysera Delivery shipments block
    1Create the shipment at order status
    2Paid order statuses
    3How you hand parcels over
    4Test mode
    1. The status at which the store creates a shipment in Paysera; “Do not create” creates none.
    2. At these statuses the shipment is marked as paid.
    3. A courier picks up or you drop at a parcel terminal; the price depends on it.
    4. Marks shipments as test; Paysera has no separate test environment.

    Paysera has no test environment: every shipment is real. “Test mode” only marks shipments as test ones, and how Paysera handles them isn't documented. Check your first shipment in your Paysera account.

    • The status matched — the shipment is created once. A repeated status, another status or two changes at the same time won't create a second one.
    • Courier and parcel locker — the ones the customer picked. For a courier — the customer's address and postcode. The recipient is the name, phone and e-mail from the order.
    • The order is already paid — that is, it has a status from “Paid order statuses” — the shipment is paid right away. If payment came later, the store marks the shipment as paid. By default these are “Processing”, “Shipped”, “Complete”.
    • Paysera refused — the new order status stays, but the shipment isn't created; the order card shows “error” and the reason. What to do is in the troubleshooting table.

    The status that triggers the shipment is set in the store by the payment module — for example, after an online payment. In the field, choose the status a paid order gets: then shipments are created only for paid orders.

    The shipment status is visible in the order card in Elbuz once the order is loaded again. The “Paysera shipment” field shows “not created yet”, “created”, “created, paid” or “error”. Next to it — “Courier”, “Shipment number”, “Tracking” and “Error reason”.

    Labels and courier pickup are in your Paysera account.

    Scenarios

    Small electronics to Lithuania without entering parcels by hand

    In “Prices and options”, keep the Omniva and LP Express parcel lockers. “Create the shipment at order status” — the paid order status. The customer sees each courier's real price, and the parcel is registered in Paysera automatically.

    Large appliances by courier only

    Turn off the parcel locker rows, keep “Paysera · Venipak — courier” and “Paysera · Omniva — courier”. “Markup, fixed” — 5 for carrying upstairs. A heavy order won't go to a parcel locker, and the price covers your work.

    Smartphones to all three countries with free delivery

    “Countries” — Lithuania, Latvia, Estonia. In the parcel locker rows, “Free from” — 40. From 40 in the store currency, parcel locker delivery is free for the customer.

    Clothing and cosmetics in one parcel

    Turn on “One parcel per order” and keep only parcel lockers. Paysera calculates one parcel per order, not a parcel per item.

    What to do when delivery doesn't work

    What you seeWhyWhat to do
    The customer doesn't see Paysera options The address country isn't among the “Countries”, the address is outside the “Geo zone”, the cart is heavier than “Up to, kg”, or Paysera gave no price with a “Fallback price” of 0 Check “Countries”, “Geo zone” and the Paysera rows in “Prices and options”. Set a “Fallback price” above 0
    No parcel lockers of the courier you need The courier isn't turned on in the Paysera project, or the parcel lockers haven't been loaded yet Turn the courier on in your Paysera account and wait a day. If you don't want to wait, Elbuz support will update the directory right away
    The “Sender address” list is empty The Paysera project has no saved sender addresses, or the keys are wrong Save an address in your Paysera account and check the ID and password. A few minutes after saving the keys, click “Refresh from store” under the field
    The order card shows “Paysera shipment: not created yet” The order hasn't got the status from “Create the shipment at order status” yet, or the field is set to “Do not create” Choose the status the payment module sets for a paid order, and save
    “Paysera shipment: error” Paysera rejected the shipment: the courier isn't on in the project, or the keys, sender address, weight or customer phone are wrong — see “Error reason” Turn the courier on in your Paysera account; fix the keys and address on the delivery screen. Then write to Elbuz support: they will create the shipment again and fix the weight and phone in the order themselves

    FAQ

    I changed the order status in Elbuz — why didn't the shipment appear?

    The store creates the shipment when the status changes in the store itself — it's set by the payment module. In “Create the shipment at order status”, choose the paid order status (how it works).

    What happens if I turn Paysera off in “Carriers”?

    Paysera options disappear from checkout. The keys, sender address and prices are kept: turn it on again and everything is in place.

    Can I ship to Ukraine or Poland via Paysera Delivery?

    No, only to Lithuania, Latvia and Estonia. For other countries, use European delivery services.

    Can I keep just one courier, for example only Omniva?

    Yes: turn off the other Paysera rows in “Prices and options”. The store loads parcel lockers only for the couriers turned on in your Paysera project.

    Can I charge the customer less for delivery than Paysera charges?

    You can't lower the price by a percentage: “VAT on the price” and the markups only add. You can make delivery free above a cart total — “Free from” (price).

    Where it is and who has access

    Menu
    Directories → Operations → Store settings → “Delivery” → “Delivery”
    Access rights
    the “Store settings” window in group permissions
    Prepare
    a contract with Paysera, a delivery project with couriers and sender addresses, the project ID and password

    Related topics

    Was this article helpful?

    Missing a feature? Tell us.

    We will add it for free if other users need it too.

    If only you need it, we will agree on it separately.

    Article contents

    Suggest an improvement

    Try Elbuz free