Main Endpoints

Get account statement

This endpoint allows you to retrieve the list of completed payments (account statement)
GET/api/1/eurowallet/payments/history
Starting from July 1, 2026, the networkType parameter will include a new value: SEPA_INSTANT. Please update your integration before this date to ensure continued compatibility.

Request

fromDate
string optional
Interval for generating account statement - start date
Format: yyyy-MM-dd Defaults to the start of the month
toDate
string optional
Interval for generating account statement - end date
Format: yyyy-MM-dd Defaults to the current date
account
string required
Your IBAN account at Nexpay for which an account statement needs to be generated

Response

Mandatory parameters

Each response contains the following mandatory data:

debitTurnover
string required
Debit turnover on the selected account for the selected period
creditTurnover
string required
Credit turnover on the selected account for the selected period
balanceStart
string required
Opening balance of the selected account for the selected period
balanceEnd
string required
Closing balance of the selected account for the selected period
clientName
string required
Your name (as registered in our system)
account
string required
Your IBAN account at Nexpay for which an account statement needs to be generated
entries
array of objects required
Array of payments

Payment entry structure

paymentId
string required
Internal payment identifier (it is returned in response to the POST /api/2/eurowallet/payments)
networkType
string required
Payment rails through which the payment should be made
Possible values: SEPA, SWIFT
If the parameter is not provided, the SEPA network is chosen by default
date
string required
Payment processing date
Format: yyyy-MM-dd format
beneficiaryName
string required
Recipient’s/sender’s name
account
string required
Recipient’s/sender’s bank account number
details
string required
Payment reference (transaction details)
amount
string required
Payment amount
runningBalance
string required
Account balance at the time of payment processing
direction
string required
Payment direction
Possible values: INCOMING (deposit), OUTGOING (withdrawal)

Conditional parameters

These parameters are only returned for incoming non-Euro payments that have been sent through the SWIFT network (networkType = SWIFT)

originalAmount
string optional
Original payment amount
originalCurrency
string optional
Original payment currency

Optional parameters

The parameters listed below are optional:

feePaymentId
string optional
Identifier of a linked commission charge transaction
externalPaymentId
string optional
Custom internal identifier shared between you and your end-customer, helping you track and reference payments across systems

Examples

GET url: /api/1/eurowallet/payments/history
GET data: fromDate=2019-05-01&toDate=2019-07-04&account=LT023080010000000239

Commentaries

The statement includes only payments that have been successfully completed. Therefore, if you made a payment and for any reason it became PENDING, you will not see that payment on the statement until it changes to COMPLETED status. Accordingly, balanceStart and balanceEnd migh also stay unchanged.

When generating a statement, there is no maximum time period or interval for which it can be requested. However, when dealing with a large volume of payments (in the thousands or tens of thousands), it is strongly recommended to break down requests into smaller time intervals. For example, when requesting a statement for a year, send twelve requests, each covering a one-month period.

Get payment details

This endpoint allows you to retrieve details of a particular payment

Get banking details

This endpoint allows you to retrieve information about your accounts (IBANs), which you can use to create payment instructions for receiving incoming payments