Skip to main content

Generate shipping label

POST https://delivery-api.paysera.com/rest/v1/orders/{id}/label

Generate a shipping label PDF for the order.

The label contains barcode, tracking information, and delivery details required by the courier.

Label Format​

Labels are generated in PDF format suitable for printing on A4 or label printers.

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.

Parameters​

Path Parameters​

NameTypeRequiredDescription
idstring✓Order ID

Example​

Request​

POST https://delivery-api.paysera.com/rest/v1/orders/{id}/label
Authorization: MAC id="CLIENT_ID", ts="TIMESTAMP", nonce="RANDOM_STRING", mac="MAC_HASH"

Response​

{
  "id": "lbl_123456",
  "order_id": "ord_123456",
  "format": "pdf",
  "url": "https://delivery-api.paysera.com/rest/v1/orders/ord_123456/label",
  "created_at": 1609459200
}

Note: The response contains a URL to download the PDF label. Use the url field to retrieve the actual PDF file with a GET request.

AUTHORIZATION: HTTP

REQUEST

Base URL
https://delivery-api.paysera.com

RESPONSE

Label generated successfully
{}