Skip to main content

Get available shipment gateways

PUT https://delivery-api.paysera.com/rest/v1/gateways

List available gateways filtered by project, countries, and shipment specifications.

Returns gateway information including ID, code, description, logo URL, and price limits.

Authorization​

This endpoint requires MAC (Message Authentication Code) authentication.

Authorization Header Format:

Authorization: MAC id="YOUR_PROJECT_ID",ts="1234567890",nonce="xyz123",mac="GENERATED_MAC_HASH"

Example:

Authorization: MAC id="a9b8c7d6e5f4g3h2", ts="1234567890", nonce="xyz123abc456def", mac="dGhpcyBpcyBhIHJhbmRvbSBtYWMgaGFzaCB2YWx1ZQ==", ext="body_hash=cmFuZG9tQm9keUhhc2hWYWx1ZQ%3D%3D"

For more details, please refer to the Authentication section.

Request Body​

FieldTypeRequiredDescription
project_idstringProject identifier (optional)
from_country_codestring✓Origin country code (ISO 3166-1 alpha-2)
to_country_codestring✓Destination country code (ISO 3166-1 alpha-2)
shipmentsarray✓Array of shipment specifications
shipment_method_codestringOptional filter by shipment method code

Example​

Request​

PUT https://delivery-api.paysera.com/rest/v1/gateways
Content-Type: application/json
Authorization: MAC id="YOUR_PROJECT_ID",ts="1234567890",nonce="xyz123",mac="GENERATED_MAC_HASH"
{
  "project_id": "proj_123",
  "from_country": "LT",
  "to_country": "LV",
  "shipments": [
    {
      "weight": 2000,
      "width": 300,
      "length": 400,
      "height": 200
    }
  ]
}

Response​

{
  "gateways": [
    {
      "id": 1,
      "code": "omniva",
      "name": "Omniva",
      "description": "Omniva parcel delivery service",
      "logo_url": "https://example.com/logos/omniva.png",
      "min_price": "2.50",
      "max_price": "15.00",
      "currency": "EUR"
    },
    {
      "id": 2,
      "code": "dpd",
      "name": "DPD",
      "description": "DPD courier service",
      "logo_url": "https://example.com/logos/dpd.png",
      "min_price": "3.00",
      "max_price": "20.00",
      "currency": "EUR"
    }
  ]
}

AUTHORIZATION: HTTP

REQUEST

Base URL
https://delivery-api.paysera.com
Body REQUIRED
{
  "project_id": "proj_123",
  "from_country": "LT",
  "to_country": "LV",
  "shipments": [
    {
      "weight": 2000,
      "width": 300,
      "length": 400,
      "height": 200
    }
  ]
}

RESPONSE

Gateways retrieved successfully
{
  "gateways": [
    {
      "id": 1,
      "code": "omniva",
      "name": "Omniva",
      "description": "Omniva parcel delivery service",
      "logo_url": "https://example.com/logos/omniva.png",
      "min_price": "2.50",
      "max_price": "15.00",
      "currency": "EUR"
    },
    {
      "id": 2,
      "code": "dpd",
      "name": "DPD",
      "description": "DPD courier service",
      "logo_url": "https://example.com/logos/dpd.png",
      "min_price": "3.00",
      "max_price": "20.00",
      "currency": "EUR"
    }
  ]
}