Pigeon Express for WooCommerce

外掛說明

Pigeon Express for WooCommerce wires the Pigeon Express courier service into your WooCommerce store. It registers three shipping methods (address delivery, Pigeon office, parcel locker), quotes live prices at checkout, and gives you a self-contained shipment workflow on every order edit screen.

Key features

• Three WooCommerce shipping methods: Address delivery, Pigeon office, Parcel locker (APS).
• Live price quotes via the Pigeon Express calculate-price endpoint, with optional fixed-price override and free-shipping threshold per method.
• In-checkout searchable office / parcel locker picker, pre-filtered by the customer’s billing postcode.
• COD-aware pricing – the shipping cost refreshes automatically when the customer switches between COD and any other payment method.
• Per-order shipment workflow on the order edit screen: editable receiver, multi-package weights + dimensions + per-package description, additional-services overrides, who-pays toggle, live delivery-type switcher.
• Label PDFs stored on disk and previewed inline; bulk ZIP download from the orders list.
• Dedicated “Pigeon Express” column on the orders list with reference + one-click label print, plus a filter dropdown for label state and delivery type.
• Optional auto-transition of order status when a label is created.
• High-Performance Order Storage (HPOS) compatible.
• Daily automated sync of Pigeon Express offices, parcel lockers, and active service codes.

Requirements

• WordPress 6.0 or newer
• WooCommerce 7.0 or newer
• PHP 7.4 or newer
• A Pigeon Express merchant account (sandbox keys for testing, live keys for production)

External services

This plugin connects to the Pigeon Express courier API to provide its core functionality. The service is operated by Pigeon Express. Use of the plugin is subject to the carrier’s terms and privacy policy.

When data is sent

• When a customer is on the checkout page and a Pigeon Express shipping method is selected, the cart total, parcel weight, delivery type, and destination (postcode / office id / parcel locker id) are sent to the carrier’s /calculate-price endpoint to obtain a live shipping quote.
• When a merchant clicks Create shipment in the order metabox, the order’s receiver details, packages, parcel description, and chosen services are sent to the carrier’s /shipments endpoint to create the shipment and receive the label PDF.
• When a merchant clicks Cancel shipment, the carrier reference is sent to the /shipments/{reference}/cancel endpoint.
• Once daily (via WordPress cron), the plugin syncs the list of Pigeon Express offices and parcel lockers and the catalogue of active service codes.

What data is sent

• Sender details from the plugin’s “Send From” settings: name, phone, email, pickup address or office id.
• Receiver details from the order: name, phone, email, delivery address (city, street, additional info) or chosen office / parcel locker id.
• Package data: weight, dimensions, description, count.
• Service flags: COD amount (if applicable), declared value (fragile), SMS notification, return receipt, ID verification, etc., based on per-method and per-order settings.

Authentication

• API requests carry X-API-Key and X-API-Secret headers built from the credentials the merchant configured. The credentials are stored as WordPress options and are never written to the WordPress debug log, never emitted in responses, never echoed in the admin UI.

Endpoints

• Base URLs: https://api-demo.pigeonexpress.com/v1 (sandbox) and https://api.pigeonexpress.com/v1 (production).
• API documentation: https://api-docs.pigeonexpress.com/
• Privacy policy: https://pigeonexpress.bg/privacy

No data is sent to any other third-party service.