curl --request GET \
--url https://api.pgw-sandbox.finventi.com/v3/payments \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.pgw-sandbox.finventi.com/v3/payments"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.pgw-sandbox.finventi.com/v3/payments', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.pgw-sandbox.finventi.com/v3/payments",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.pgw-sandbox.finventi.com/v3/payments"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.pgw-sandbox.finventi.com/v3/payments")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pgw-sandbox.finventi.com/v3/payments")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"amount": 100,
"createdAt": "2023-11-07T05:31:56Z",
"creditor": {
"account": "<string>",
"bic": "<string>",
"name": "<string>"
},
"currency": "EUR",
"debtor": {
"account": "<string>",
"bic": "<string>",
"name": "<string>"
},
"direction": "OUTBOUND",
"endToEndId": "<string>",
"id": 10300007,
"metadata": [
"<string>"
],
"scheme": "SEPA_CT",
"status": "COMPLETED",
"type": "PAYMENT",
"adjustmentDisplayParties": {
"creditor": {
"account": "<string>",
"bic": "<string>",
"name": "<string>"
},
"debtor": {
"account": "<string>",
"bic": "<string>",
"name": "<string>"
}
},
"parentPaymentId": 123,
"settlementDate": "2023-12-25",
"uetr": "<string>"
}
],
"meta": {
"nextPageToken": "<string>",
"previousPageToken": "<string>"
}
}{
"code": "<string>",
"data": {
"errors": [
{
"code": "<string>",
"field_name": "<string>",
"message": "<string>",
"value": "<string>"
}
],
"message": "<string>"
},
"message": "<string>"
}{
"code": "<string>",
"data": {
"errors": [
{
"code": "<string>",
"field_name": "<string>",
"message": "<string>",
"value": "<string>"
}
],
"message": "<string>"
},
"message": "<string>"
}Get transactions list
Retrieves payment summaries with cursor-based pagination and filtering options.
curl --request GET \
--url https://api.pgw-sandbox.finventi.com/v3/payments \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.pgw-sandbox.finventi.com/v3/payments"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.pgw-sandbox.finventi.com/v3/payments', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.pgw-sandbox.finventi.com/v3/payments",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.pgw-sandbox.finventi.com/v3/payments"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.pgw-sandbox.finventi.com/v3/payments")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pgw-sandbox.finventi.com/v3/payments")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"amount": 100,
"createdAt": "2023-11-07T05:31:56Z",
"creditor": {
"account": "<string>",
"bic": "<string>",
"name": "<string>"
},
"currency": "EUR",
"debtor": {
"account": "<string>",
"bic": "<string>",
"name": "<string>"
},
"direction": "OUTBOUND",
"endToEndId": "<string>",
"id": 10300007,
"metadata": [
"<string>"
],
"scheme": "SEPA_CT",
"status": "COMPLETED",
"type": "PAYMENT",
"adjustmentDisplayParties": {
"creditor": {
"account": "<string>",
"bic": "<string>",
"name": "<string>"
},
"debtor": {
"account": "<string>",
"bic": "<string>",
"name": "<string>"
}
},
"parentPaymentId": 123,
"settlementDate": "2023-12-25",
"uetr": "<string>"
}
],
"meta": {
"nextPageToken": "<string>",
"previousPageToken": "<string>"
}
}{
"code": "<string>",
"data": {
"errors": [
{
"code": "<string>",
"field_name": "<string>",
"message": "<string>",
"value": "<string>"
}
],
"message": "<string>"
},
"message": "<string>"
}{
"code": "<string>",
"data": {
"errors": [
{
"code": "<string>",
"field_name": "<string>",
"message": "<string>",
"value": "<string>"
}
],
"message": "<string>"
},
"message": "<string>"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Maximum number of payments returned per page. The default is 10 and the maximum is 100.
1 <= x <= 100Cursor token for fetching the next page. Do not send it together with previousPageToken, and keep all filters identical to the request that returned the token.
Cursor token for fetching the previous page. Do not send it together with nextPageToken, and keep all filters identical to the request that returned the token.
Filter by payment identifier.
10300007
Filter by debtor agent BIC.
"LUNALT22XXX"
Filter by creditor agent BIC.
"NOVALT22XXX"
Filter payments created at or after this UTC timestamp.
"2026-01-01T00:00:00Z"
Filter payments created at or before this UTC timestamp.
"2026-01-31T23:59:59Z"
Filter payments with a settlement date on or after this date.
"2026-01-01"
Filter payments with a settlement date on or before this date.
"2026-01-31"
Filter by the end-to-end identifier assigned by the originator.
Filter by exact UETR, independently of endToEndId.
Filter by an exact client-defined metadata value.
Filter by one or more payment schemes using the same values returned in the response scheme field.
SEPA_CT, SEPA_INST, SEPA_DD, SWIFT, T2 Filter by payment direction.
OUTBOUND, INBOUND Filter by parent payment identifier.
Filter by a payment identifier or its parent payment identifier.
Filter by payment type using the same value returned in the response type field. Deprecated, use types instead.
PAYMENT, PAYMENT_CANCELLATION, PAYMENT_RETURN, REVERSE_PAYMENT, CSM_FEES, ADJUSTMENT Filter by one or more payment types using repeated query parameters, for example types=PAYMENT&types=PAYMENT_RETURN. Values match the response type field. Combined with type when both are sent.
PAYMENT, PAYMENT_CANCELLATION, PAYMENT_RETURN, REVERSE_PAYMENT, CSM_FEES, ADJUSTMENT Filter by one or more payment statuses using repeated query parameters, for example statuses=TO_SIGN&statuses=SIGNED. Values match the response status field.
CREATED, TO_SIGN, SIGNED, SENT_TO_CLEAR, COMPLETED, CANCELLED, REJECTED, ACCEPTED, SOME_PROBLEMS, PENDING_CONFIRMATION ISO 4217 currency used both as a filter and for interpreting all amount range parameters. Defaults to EUR when any amount range parameter is supplied.
^[A-Z]{3}$"EUR"
Minimum payment amount in minor units of currency, inclusive.
100
Maximum payment amount in minor units of currency, inclusive.
10000
Minimum unaccounted tax amount in minor units of currency, inclusive. The matching value is available as chargesAndAdjustments.unaccountedTax from GET /v3/payments/{id}.
Maximum unaccounted tax amount in minor units of currency, inclusive. The matching value is available as chargesAndAdjustments.unaccountedTax from GET /v3/payments/{id}.
Minimum compensation amount in minor units of currency, inclusive. The matching value is available as chargesAndAdjustments.compensation from GET /v3/payments/{id}.
Maximum compensation amount in minor units of currency, inclusive. The matching value is available as chargesAndAdjustments.compensation from GET /v3/payments/{id}.
Filter by debtor account identifier.
Filter by creditor account identifier.
Exclude payments that have an existing non-rejected payment return.