Payments

Read the payment records associated with your orders.

A payment represents a single attempt to pay an order through a chosen payment method. Use these endpoints to look up a payment or list payments for your project.

Amount Format

All amounts are in minor currency units (e.g., cents for EUR) and returned as integers (e.g., 2500 for €25.00).

Get a Payment

GET /payment-executor/integration/v1/payments/{id}

Retrieves a single payment by its identifier. The payment must belong to your project.

Request

curl https://api.paysera.com/payment-executor/integration/v1/payments/{id} \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Path Parameters

Parameter	Type	Required	Description
id	UUID	Yes	Payment identifier

Response

{
  "id": "0c2d4e6a-1b3c-4d5e-9f8a-2b4c6d8e0f12",
  "order_id": "a6f2b8e3-5e5f-47d9-b13f-87ed2db2938a",
  "order_reference": "ORDER-12345",
  "project_id": "your-project-id",
  "amount": 2500,
  "currency": "EUR",
  "status": "settled",
  "payment_method_id": "3f9a1c20-7b4d-4e8a-9c1f-5d6e7a8b9c0d",
  "payment_method_key": "swedbank",
  "payment_method_name": "Swedbank",
  "payment_method_type": "banklink",
  "purpose": "Order #12345",
  "original_amount": null,
  "original_currency": null,
  "exchange_rate": null,
  "external_payment_id": "EXT-998877",
  "created_at": 1736433500,
  "updated_at": 1736433570
}

Response Fields

Field	Type	Description
id	UUID	Payment identifier
order_id	UUID	Associated order identifier
order_reference	string	Merchant reference of the order
project_id	string	Project the payment belongs to
amount	integer	Amount in minor units
currency	string	ISO 4217 currency
status	string	Payment status
payment_method_id	string	Payment method identifier
payment_method_key	string	Payment method key (e.g., swedbank)
payment_method_name	string	Human-readable payment method name
payment_method_type	string	Payment method type (e.g., banklink)
purpose	string	Payment purpose
original_amount	integer	Original amount before conversion (nullable)
original_currency	string	Original currency before conversion (nullable)
exchange_rate	number	Applied exchange rate (nullable)
external_payment_id	string	Identifier in the external provider system
created_at	integer	Creation Unix timestamp (seconds)
updated_at	integer	Last update Unix timestamp (seconds)

List Payments

GET /payment-executor/integration/v1/payments

Returns a cursor-paginated list of payments for your project. Filters can be combined freely.

Request

curl "https://api.paysera.com/payment-executor/integration/v1/payments?order_id=ORDER_ID&limit=20" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Query Parameters

Parameter	Type	Description
order_id	UUID	Filter by order
status[]	string	Filter by one or more payment statuses
payment_method_id[]	string	Filter by payment method id
payment_method_key[]	string	Filter by payment method key
currency[]	string	Filter by ISO 4217 currency
amount, amount_gte, amount_lte	integer	Exact / range filter on amount (minor units)
created_at_gte, created_at_lte	integer	Created-at range (Unix seconds)
q	string	Free-text search over order_reference (max 255 chars)
cursor	string	Pagination cursor
limit	integer	Page size
sort	string	Sort order

Response

{
  "items": [
    {
      "id": "0c2d4e6a-1b3c-4d5e-9f8a-2b4c6d8e0f12",
      "order_id": "a6f2b8e3-5e5f-47d9-b13f-87ed2db2938a",
      "amount": 2500,
      "currency": "EUR",
      "status": "settled",
      "payment_method_key": "swedbank",
      "created_at": 1736433500
    }
  ],
  "cursor": "eyJpZCI6Li4ufQ==",
  "has_more": true
}

Related Documentation

• Payment Orders - Read and manage orders
• Refunds - Initiate and track refunds
• Activity - Event log for orders and payments