Update order

PATCH https://pos.paysera.com/epapi/v1/orders/{id}

Update an existing order's details.

You can update order information such as customer details, positions, payments, and other attributes.

Note: Not all fields may be updatable depending on the order status.

Authorization

This endpoint requires MAC (Message Authentication Code) authentication.

Authorization Header Format:

Authorization: MAC id="CLIENT_ID", ts="TIMESTAMP", nonce="RANDOM_STRING", mac="MAC_HASH", ext="body_hash=BODY_HASH"

Example:

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

For more details, see the Authentication section.

Parameters

Path Parameters

Name	Type	Required	Description
id	string	✓	Order UUID

Request Body

Field	Type	Required	Description
number	string
currency	string
languageCode	string
discountPrice	number
expiresAt	string
reservationName	string
reservationComment	string
customer	object
orderPositions	array
payments	array

Example

Request

PATCH https://pos.paysera.com/epapi/v1/orders/{id}
Content-Type: application/json
Authorization: MAC id="CLIENT_ID", ts="TIMESTAMP", nonce="RANDOM_STRING", mac="MAC_HASH", ext="body_hash=BODY_HASH"

{}

Response

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "number": "ORD-2024-158",
  "currency": "EUR",
  "languageCode": "en",
  "status": "confirmed",
  "totalPrice": 5499,
  "discountPrice": 500,
  "createdAt": "2024-11-04T10:15:30Z",
  "updatedAt": "2024-11-04T11:00:00Z",
  "customer": {
    "email": "updated@example.com",
    "name": "Jane Smith-Updated",
    "phone": "+37060012345"
  },
  "orderPositions": [
    {
      "id": "pos-1",
      "productId": "PROD123",
      "name": "Wireless Mouse",
      "quantity": 1,
      "price": 2999,
      "totalPrice": 2999,
      "vatRate": 21,
      "vatAmount": 519
    },
    {
      "id": "pos-2",
      "productId": "PROD456",
      "name": "USB Cable",
      "quantity": 2,
      "price": 1500,
      "totalPrice": 3000,
      "vatRate": 21,
      "vatAmount": 519
    }
  ],
  "payments": [
    {
      "id": "pay-1",
      "type": "card",
      "amount": 4999,
      "status": "completed",
      "timestamp": "2024-11-04T10:20:30Z"
    }
  ]
}

AUTHORIZATION: HTTP

REQUEST

Base URL

https://pos.paysera.com

RESPONSE

Order updated successfully

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "number": "ORD-2024-158",
  "currency": "EUR",
  "languageCode": "en",
  "status": "confirmed",
  "totalPrice": 5499,
  "discountPrice": 500,
  "createdAt": "2024-11-04T10:15:30Z",
  "updatedAt": "2024-11-04T11:00:00Z",
  "customer": {
    "email": "updated@example.com",
    "name": "Jane Smith-Updated",
    "phone": "+37060012345"
  },
  "orderPositions": [
    {
      "id": "pos-1",
      "productId": "PROD123",
      "name": "Wireless Mouse",
      "quantity": 1,
      "price": 2999,
      "totalPrice": 2999,
      "vatRate": 21,
      "vatAmount": 519
    },
    {
      "id": "pos-2",
      "productId": "PROD456",
      "name": "USB Cable",
      "quantity": 2,
      "price": 1500,
      "totalPrice": 3000,
      "vatRate": 21,
      "vatAmount": 519
    }
  ],
  "payments": [
    {
      "id": "pay-1",
      "type": "card",
      "amount": 4999,
      "status": "completed",
      "timestamp": "2024-11-04T10:20:30Z"
    }
  ]
}