Skip to main content

Set the bound cash register for the session

POST https://pos.paysera.com/eapi/v1/session/cash-register

Bind a cash register to the current session so subsequent requests operate against it.

Authorization​

This endpoint requires a Personal Access Token, sent as a Bearer token.

To obtain one, your account needs API permission. Once granted, go to /user/settings in your POS account and create a personal access token.

Authorization Header Format:

Authorization: Bearer YOUR_ACCESS_TOKEN

Example:

Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...

For more details, see the Authentication section.

Request Body​

FieldTypeRequiredDescription
cashRegisterIdinteger✓ID of a cash register that is active and available to the user

Errors​

This endpoint may return the following errors:

400 - Bad Request​

Invalid request

This error is resulted by incorrectly providing one of the parameters.

401 - Unauthorized​

Unauthorized

This error was produced by providing incorrect credentials.

403 - Forbidden​

Forbidden

This error indicates you don't have permission to access this resource.

404 - Not Found​

Cash register not found

This error indicates the requested resource was not found.

422 - Unprocessable Entity​

Unprocessable entity

429 - Too Many Requests​

Rate limit exceeded

500 - Internal Server Error​

Internal server error

Example​

Request​

POST https://pos.paysera.com/eapi/v1/session/cash-register
Content-Type: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN
{
  "cashRegisterId": 12
}

Response​

{
  "user": {
    "name": "Jonas Kasininkas",
    "language": "en"
  },
  "tenant": {
    "companyName": "Acme Store",
    "tapToPayEnabled": true,
    "checkoutEnabled": true
  },
  "cashRegister": {
    "id": 1,
    "number": "CR-000000001",
    "title": {
      "lt": "PagrindinÄ— kasa",
      "en": "Main register"
    },
    "type": "vfiscal",
    "status": "active",
    "environment": "production",
    "broadcastChannel": "a1b2c3d4",
    "cardPaymentTerminalId": 42
  },
  "fiscalization": true,
  "layout": "classic"
}

AUTHORIZATION: HTTP

REQUEST

Base URL
https://pos.paysera.com
Body REQUIRED
{
  "cashRegisterId": 12
}

RESPONSE

Cash register bound successfully
{
  "user": {
    "name": "Jonas Kasininkas",
    "language": "en"
  },
  "tenant": {
    "companyName": "Acme Store",
    "tapToPayEnabled": true,
    "checkoutEnabled": true
  },
  "cashRegister": {
    "id": 1,
    "number": "CR-000000001",
    "title": {
      "lt": "PagrindinÄ— kasa",
      "en": "Main register"
    },
    "type": "vfiscal",
    "status": "active",
    "environment": "production",
    "broadcastChannel": "a1b2c3d4",
    "cardPaymentTerminalId": 42
  },
  "fiscalization": true,
  "layout": "classic"
}