Search payments

GET https://wallet.paysera.com/rest/v1/payments

Search for payments by filters.

Example queries:

• New payments: GET /payments?status=new
• Done payments to yourself: GET /payments?beneficiary=none&status=done

Note: Permission checks may apply based on beneficiary and project filters. order_by / order_direction are not supported for this endpoint, and there's no currency, price, or date-range filter beyond the after/before cursors.

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		Payment status: new, waiting, waiting_funds, waiting_registration, waiting_password, revoked, rejected, failed, reserved, confirmed, done, or canceled
wallet	integer		Payer's wallet ID
beneficiary	string		Beneficiary wallet ID, or none for no beneficiary
purpose	string		Payment purpose
project_id	integer		Project ID to filter by. If omitted, scoped to your current project unless you have permission to search all transactions
limit	integer		Maximum number of results (1-200, default 20)
offset	integer		Number of results to skip. Mutually exclusive with after/before
after	string		Cursor for next page. Mutually exclusive with offset/before
before	string		Cursor for previous page. Mutually exclusive with offset/after

Note: order_by and order_direction are not supported by this endpoint.

Example

Request

GET https://wallet.paysera.com/rest/v1/payments?status=new&limit=50
Authorization: MAC id="CLIENT_ID", ts="TIMESTAMP", nonce="RANDOM_STRING", mac="MAC_HASH"

Response

[
  {
    "id": 2987,
    "transaction_key": "pDAlAZ3z",
    "created_at": 1355314332,
    "status": "new",
    "price": 1299,
    "currency": "EUR",
    "price_decimal": "12.99",
    "freeze": {
      "for": 0
    },
    "description": "Payment for order No. 1234",
    "parameters": {
      "orderid": 1234
    }
  },
  {
    "id": 2988,
    "transaction_key": "qEBmBA4A",
    "created_at": 1355314400,
    "status": "done",
    "price": 500,
    "currency": "EUR",
    "price_decimal": "5.00",
    "freeze": {
      "for": 0
    },
    "description": "Payment for order No. 1235",
    "parameters": {
      "orderid": 1235
    }
  }
]

AUTHORIZATION: HTTP

REQUEST

Base URL

https://wallet.paysera.com

Query Parameters

status

Payment status

wallet

Payer's wallet ID

beneficiary

Beneficiary wallet ID, or 'none' for no beneficiary

purpose

Payment purpose

project_id

Project ID to filter by. If omitted, scoped to your current project unless you have permission to search all transactions.

limit

Maximum number of results (1-200)

offset

Number of results to skip. Mutually exclusive with after/before.

after

Cursor for next page. Mutually exclusive with offset/before.

before

Cursor for previous page. Mutually exclusive with offset/after.

RESPONSE

Payments found

[
  {
    "id": 2987,
    "transaction_key": "pDAlAZ3z",
    "created_at": 1355314332,
    "status": "new",
    "price": 1299,
    "currency": "EUR",
    "price_decimal": "12.99",
    "freeze": {
      "for": 0
    },
    "description": "Payment for order No. 1234",
    "parameters": {
      "orderid": 1234
    }
  },
  {
    "id": 2988,
    "transaction_key": "qEBmBA4A",
    "created_at": 1355314400,
    "status": "done",
    "price": 500,
    "currency": "EUR",
    "price_decimal": "5.00",
    "freeze": {
      "for": 0
    },
    "description": "Payment for order No. 1235",
    "parameters": {
      "orderid": 1235
    }
  }
]