}

Get all notifications

GET https://checkout-eu-a.paysera.com/notification/rest/v1/notifications

Retrieve all notifications belonging to the client with optional filtering and pagination.

Use the status parameter to filter by notification status (new or read).

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

Query Parameters

Name	Type	Required	Description
status	string		Filter by notification status
limit	integer		Maximum number of results
offset	integer		Offset for pagination
order_by	string		Field to order by
order_direction	string		Order direction
after	string		Cursor for pagination (after)
before	string		Cursor for pagination (before)

Example

Request

GET https://checkout-eu-a.paysera.com/notification/rest/v1/notifications?status=new&limit=20&offset=0&order_by=id&order_direction=desc
Authorization: MAC id="CLIENT_ID", ts="TIMESTAMP", nonce="RANDOM_STRING", mac="MAC_HASH"

Response

{
  "items": [
    {
      "id": "xyz789notification",
      "status": "new",
      "event": "payment_request.captured",
      "data": {
        "payment_request": {
          "id": "abc123payment",
          "status": "captured",
          "order_id": "SUB_12345"
        }
      },
      "created_at": 1734258645
    },
    {
      "id": "xyz788notification",
      "status": "new",
      "event": "payment_request.captured",
      "data": {
        "payment_request": {
          "id": "abc124payment",
          "status": "captured",
          "order_id": "SUB_12346"
        }
      },
      "created_at": 1734182430
    }
  ],
  "_metadata": {
    "total": 45,
    "offset": 0,
    "limit": 20,
    "order_by": "id",
    "order_direction": "desc",
    "has_next": true,
    "has_previous": false,
    "cursors": {
      "after": "xyz788notification",
      "before": "xyz789notification"
    }
  }
}

AUTHORIZATION: HTTP

REQUEST

Base URL

https://checkout-eu-a.paysera.com

Query Parameters

status

Filter by notification status

limit

Maximum number of results

offset

Offset for pagination

order_by

Field to order by

order_direction

Order direction

after

Cursor for pagination (after)

before

Cursor for pagination (before)

RESPONSE

List of notifications

{
  "items": [
    {
      "id": "xyz789notification",
      "status": "new",
      "event": "payment_request.captured",
      "data": {
        "payment_request": {
          "id": "abc123payment",
          "status": "captured",
          "order_id": "SUB_12345"
        }
      },
      "created_at": 1734258645
    },
    {
      "id": "xyz788notification",
      "status": "new",
      "event": "payment_request.captured",
      "data": {
        "payment_request": {
          "id": "abc124payment",
          "status": "captured",
          "order_id": "SUB_12346"
        }
      },
      "created_at": 1734182430
    }
  ],
  "_metadata": {
    "total": 45,
    "offset": 0,
    "limit": 20,
    "order_by": "id",
    "order_direction": "desc",
    "has_next": true,
    "has_previous": false,
    "cursors": {
      "after": "xyz788notification",
      "before": "xyz789notification"
    }
  }
}