Skip to main content

Obtaining Credentials

This guide walks you through the seven-step process to obtain API credentials for the Paysera Delivery API, based on the official Paysera setup flow.

Service Availability

Delivery API is currently available only in Lithuania (LT), Latvia (LV), and Estonia (EE).

Overview​

To use the Delivery API, you need to:

  1. Review the documentation
  2. Create and verify a Paysera account
  3. Activate payment collection service
  4. Create a project
  5. Order delivery service
  6. Configure e-shop details
  7. Obtain your project_id and sign_password

Step 1: Review Documentation​

Before starting, review the Delivery API Overview to confirm this service meets your needs and understand:

  • Integration methods available
  • Supported countries and couriers
  • API capabilities and limitations

Step 2: Create Paysera Account​

Register for a Paysera account and complete identity verification:

  1. Visit Registration Page

  2. Complete Registration

    • Fill in required information
    • Provide valid email and phone number
    • Create secure password

  3. Identity Verification (KYC)

    • Upload required documents:
      • Personal ID or passport
      • Proof of address (for business: company registration)
      • Additional documents as requested
    • Wait for verification (typically 1-2 business days)
Verification Tips

Ensure all documents are clear, valid, and not expired. This prevents delays in account approval.

Step 3: Activate Payment Collection Service​

The Delivery API requires payment collection service to be activated first:

  1. Log in to Paysera Account

    • Access your Paysera dashboard

  2. Navigate to Service Management

    • Go to Settings → Profile Settings → Service Management

  3. Order Payment Collection

    • Find "Online payment collection via e-banking and other systems"
    • Click Order to activate
    • Accept terms and conditions
    • Wait for approval (usually within 24 hours)

Step 4: Create Project​

Create a project for your delivery integration:

  1. Navigate to Projects

    • Go to "Project and Activities" → "My Projects"

  2. Add New Project

    • Click "Add new project" or "Create New Project"

  3. Fill in Project Information

    • Project name: Your store or business name
    • Business description: Describe your e-commerce business
    • Website URL: Your website address
    • Service details: What you sell and expected volume

  4. Submit and Wait for Approval

    • Review all information
    • Submit the project
    • Wait for project approval
Project Activation

You don't need to activate the project immediately. You can configure all settings first and activate it later.

Step 5: Order Delivery Service​

After your project is created, order the delivery service:

  1. Access Service Management

    • Navigate to Settings → Profile Settings → Service Management

  2. Find Delivery Section

    • Locate the Delivery service option

  3. Order Delivery Service

    • Click Order button
    • Accept delivery service terms
    • Submit activation request

Step 6: Configure E-shop Details​

Configure your warehouse address and contact information:

  1. Navigate to Delivery Settings

    • Go to Delivery → Settings
    • Select your project if prompted

  2. Add Storage Address

    • Warehouse/pickup location address
    • Street, city, postal code
    • Country (LT, LV, or EE)

  3. Enter Contact Information

    • Contact person name
    • Phone number (mobile only)
    • Email address
    • Business hours for pickups

Example configuration:

{
  "storage_address": {
    "street": "Warehouse Street 5",
    "city": "Vilnius",
    "postal_code": "01001",
    "country": "LT"
  },
  "contact": {
    "person": "John Doe",
    "phone": "+37060000001",
    "email": "warehouse@mystore.com"
  },
  "business_hours": "Mon-Fri 09:00-18:00"
}
  1. Save Configuration

Step 7: Obtain API Credentials​

Your integration credentials are now available in project settings:

  1. Access Project Settings

    • Go to Project and Activities → My Projects
    • Click on your project name
    • Navigate to General Project Settings

  2. Find Your Credentials

    You will see two essential credentials:

    ParameterDescriptionUsage in API
    project_idYour unique project identifierUsed as mac_id in MAC authentication
    sign_passwordSecret key for request signingUsed as mac_secret in MAC authentication

  3. Secure Your Credentials

    # Example: Store as environment variables
    export PAYSERA_PROJECT_ID="your_project_id"
    export PAYSERA_SIGN_PASSWORD="your_sign_password"
Security Warning

Never expose your sign_password in:

  • Client-side code or JavaScript
  • Public repositories (GitHub, GitLab, etc.)
  • Log files or error messages
  • API responses or emails

Always store credentials securely using environment variables or secret management systems.

Authentication with Your Credentials​

Once you have your credentials, you'll use them for MAC authentication in all API requests:

// Example: Using credentials in authentication
const projectId = process.env.PAYSERA_PROJECT_ID;      // Used as mac_id
const signPassword = process.env.PAYSERA_SIGN_PASSWORD; // Used as mac_secret

// Generate MAC authentication header
const authHeader = generateMacAuth(
  'POST',
  '/rest/v1/orders',
  'delivery-api.paysera.com',
  443,
  projectId,
  signPassword
);

For complete authentication examples, see API Fundamentals.

Video Tutorials​

Paysera provides video tutorials for:

  • Account setup and registration
  • Project creation process
  • Service activation walkthrough

Check the Paysera help center for the latest tutorial videos.

Delivery Pricing​

Before starting your integration, review delivery pricing to understand costs:

Supported Couriers & Rates​

  • Omniva - Parcel lockers and courier (LT, LV, EE)
  • LP Express - Parcel machines and courier (LT)
  • Venipak - Courier delivery (LT, LV, EE)
  • SmartPosti - Including remote areas (LT)

Quick Pricing Reference:

  • Parcel Lockers: From €1.50
  • Courier Delivery (cities): From €6.90
  • Cross-Border: From €4.60 (locker) / €8.20 (courier)

View Complete Pricing & Fees →

Prices exclude VAT and vary by package size, weight, and destination

Next Steps​

Now that you have your credentials, choose your integration method:

Use Pre-Built Plugins​

For popular e-commerce platforms:

→ View Delivery Plugins

Available plugins:

  • OpenCart (3.x and 4.x)
  • PrestaShop
  • WooCommerce

Custom Integration​

Build a custom integration:

→ PHP Library Integration

→ API Fundamentals

→ Request Parameters

Support Resources​