Get non-fiscal return document

GET https://pos.paysera.com/epapi/v1/cash-registers/{number}/return/{id}

Retrieve detailed information about a non-fiscal return document.

Return documents are issued when products are returned by customers.

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
number	string	✓	Cash register identifier/number
id	string	✓	Return document identifier

Example

Request

GET https://pos.paysera.com/epapi/v1/cash-registers/{number}/return/{id}
Authorization: MAC id="CLIENT_ID", ts="TIMESTAMP", nonce="RANDOM_STRING", mac="MAC_HASH"

Response

{
  "id": "RET20240123001",
  "number": "RTN-2024-001",
  "cashRegisterNumber": "REG001",
  "fiscalDayNumber": 125,
  "amount": 1999,
  "currency": "EUR",
  "status": "completed",
  "createdAt": "2024-11-04T11:30:00Z",
  "originalReceiptId": "RCP20240123001",
  "lineItems": [
    {
      "description": "USB Cable",
      "quantity": 1,
      "unitPrice": 1500,
      "totalPrice": 1500,
      "vatRate": 21,
      "vatAmount": 260
    }
  ]
}

AUTHORIZATION: HTTP

REQUEST

Base URL

https://pos.paysera.com

RESPONSE

Return document retrieved successfully

{
  "id": "RET20240123001",
  "number": "RTN-2024-001",
  "cashRegisterNumber": "REG001",
  "fiscalDayNumber": 125,
  "amount": 1999,
  "currency": "EUR",
  "status": "completed",
  "createdAt": "2024-11-04T11:30:00Z",
  "originalReceiptId": "RCP20240123001",
  "lineItems": [
    {
      "description": "USB Cable",
      "quantity": 1,
      "unitPrice": 1500,
      "totalPrice": 1500,
      "vatRate": 21,
      "vatAmount": 260
    }
  ]
}