Skip to main content

Frequently Asked Questions

Common questions and answers about implementing and using the Paysera Delivery API.

Authentication Notice

All API requests require MAC (Message Authentication Code) authentication using your project_id and sign_password.

For complete authentication implementation with working code examples in JavaScript, PHP, and Python, see API Fundamentals - Authentication.

Quick Navigation

Use the tabs below to find answers by category. Click any question to expand the answer.

General Questions​

What is the Paysera Delivery API?

The Paysera Delivery API is a unified logistics platform that allows you to integrate multiple courier services through a single API. Instead of managing separate integrations with DPD, DHL, Omniva, and other carriers, you can use one API to:

  • Create and manage shipments
  • Track packages in real-time
  • Generate shipping labels
  • Handle returns
  • Access pre-negotiated rates

This saves development time and provides access to competitive shipping rates without individual courier contracts.

Which countries and couriers are supported?

Supported Countries​

The API primarily operates in:

  • Baltic States: Lithuania, Latvia, Estonia
  • European Union: All EU countries for international shipping
  • United Kingdom: Available for cross-border deliveries

Available Couriers​

CourierCoverageServices
DPDEurope-wideStandard, Express, Saturday
DHLGlobalExpress, Economy, Same-day
OmnivaBalticsParcel machines, Home delivery
LP ExpressLithuaniaNext-day, Parcel lockers
VenipakBaltics + PolandStandard, Express, C.O.D.

The API automatically selects the best courier based on destination, package specs, and your preferences.

Do I need separate contracts with each courier?

No! This is one of the main benefits of using Paysera Delivery API. We have pre-existing agreements with all supported couriers, so you can:

  • Access multiple courier services immediately
  • Benefit from our negotiated bulk rates
  • Avoid lengthy contract negotiations
  • Skip individual courier onboarding processes
  • Receive consolidated billing through Paysera

You only need a Paysera partner account to access all courier services.

Getting Started​

How do I get API credentials?

Follow these steps to obtain your API credentials:

  1. Create Paysera Account

  2. Apply for Partner Status

    • Go to account settings
    • Select "Online payment collection"
    • Apply for delivery partner status

  3. Create Project

    • Navigate to "My Projects"
    • Create new project with type "Delivery"
    • Configure your business details

  4. Receive Credentials

    • project_id: Your unique identifier
    • api_key: For API authentication (starts with pk_live_)
    • webhook_secret: For webhook signature verification

  5. Start Integration

    • Implement API endpoints
    • Test with small real orders
    • Scale up when validated

How do I verify the integration?

Verifying in Production (No Test Environment)​

Production Only

Delivery API operates in production mode only. There is no sandbox or test environment. All orders created are real and will be processed by actual couriers.

Recommended Verification Approach:

  1. Create Small Real Orders

    • Use lightweight, minimal value items
    • Ship to your own address or office
    • Start with 1-2 orders to validate the entire flow

  2. Use Your Own Addresses for Verification

    const verificationOrder = {
      order_id: `VERIFY-${Date.now()}`,
      pickup: {
        name: 'Your Office',
        address: 'Your Office Address',
        // ... your details
      },
      delivery: {
        name: 'Your Name',
        address: 'Your Home or Office Address',
        // ... address you control
      },
      parcel: {
        weight: 500, // grams (0.5 kg)
        dimensions: { length: 100, width: 100, height: 100 }, // mm
        value: 5.00, // EUR - low value item
        description: 'Integration verification package'
      }
    };

  3. Order Management

    • Orders can sometimes be cancelled shortly after creation
    • Contact support about cancellation policies
    • Cancelled orders may still incur minimal fees

  4. Track Verification Orders

    • Use clear naming convention (e.g., VERIFY-xxx)
    • Monitor webhook responses
    • Keep separate records for verification orders

How long does the integration typically take?

Integration timeline depends on your requirements:

Basic Integration (1-2 days)​

  • Create delivery orders
  • Track packages
  • Basic webhook handling

Standard Integration (3-5 days)​

  • All basic features
  • Label generation
  • Returns management
  • Error handling
  • Verification with real orders

Advanced Integration (1-2 weeks)​

  • Custom courier selection logic
  • Batch operations
  • Advanced webhook processing
  • Multiple pickup locations
  • Custom reporting
  • Production optimization

Most merchants complete a functional integration in 3-5 days.