Skip to main content

Delivery API Reference

Version: 1.0.0

The Paysera Delivery API allows you to manage shipment orders, generate labels and manifests, configure delivery methods, and track shipments programmatically.

Base URL​

  • Production: https://delivery-api.paysera.com/rest/v1

Authentication​

All Delivery API endpoints require MAC (Message Authentication Code) authentication based on OAuth 2.0.

Authorization Header Format:

Authorization: MAC id="YOUR_PROJECT_ID",ts="TIMESTAMP",nonce="RANDOM_STRING",mac="GENERATED_MAC_HASH"

Example:

Authorization: MAC id="123456", ts="1700574800", nonce="abc123", mac="dGhpcyBpcyBhIHJhbmRvbSBtYWMgaGFzaCB2YWx1ZQ=="

Credential Mapping:

  • project_id → MAC identifier (id)
  • sign_password → MAC secret (used to generate mac)

For more details, please refer to the Delivery API Authentication Documentation.

API Features​

Configuration & Setup​

Manage shipment methods, gateways, package sizes, and shipment points (sender/receiver addresses). Supports bulk import of shipment points.

Order Management​

Create and manage delivery orders, update order status, generate shipping labels and manifests, export orders for reporting, and track shipments.

Location Services​

Validate addresses, search post offices and parcel machines, and retrieve city and country lists.

Pricing & Calculation​

Calculate shipping costs before order creation, get order number suggestions, and validate shipment addresses.

Pagination​

List endpoints support pagination with the following parameters:

  • limit - Maximum number of items to return (default: 10)
  • offset - Number of items to skip (default: 0)

Example:

GET /orders?limit=20&offset=0

Rate Limits​

The API implements rate limiting to ensure service stability. If you exceed the rate limit, you will receive a 429 Too Many Requests response.

Contact​

Paysera Support: tech_support@paysera.com Website: https://www.paysera.com