Skip to main content

POS API Reference

Version: 1.0.0

The Paysera POS (Point of Sale) API allows you to manage cash registers, orders, invoices, and financial documents programmatically.

Base URL​

https://pos.paysera.com/epapi/v1

Authentication​

All POS API endpoints require 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 detailed information about MAC authentication, please refer to our Authentication Guide.

API Features​

Orders Management​

Create, retrieve, update, and cancel orders. Each order can contain multiple positions (products/services), customer information, and payment details.

Cash Register​

Monitor the status of cash registers, including operational state, fiscal day information, and current balance.

Financial Documents​

Access various financial documents including:

  • Fiscal receipts
  • Non-fiscal return documents
  • Non-fiscal collection documents
  • Fiscal day reports

Invoices​

Manage invoices generated from completed orders, including detailed billing information and payment status.

Pagination​

List endpoints support pagination with the following parameters:

  • page - Page number (≥1, default: 1)
  • pageSize - Items per page (1-100, default: 10)

Example:

GET /orders?page=1&pageSize=20

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