Get payment by ID
curl --request GET \
--url https://api.pgw-sandbox.finventi.com/v3/payments/{id}import requests
url = "https://api.pgw-sandbox.finventi.com/v3/payments/{id}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.pgw-sandbox.finventi.com/v3/payments/{id}', 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/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$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/{id}"
req, _ := http.NewRequest("GET", url, nil)
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/{id}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pgw-sandbox.finventi.com/v3/payments/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"createdAt": "2025-11-21T12:46:54.321667Z",
"creditor": {
"account": {
"iban": "<string>",
"other": {
"id": "<string>",
"issuer": "<string>",
"scheme": {
"code": "<string>",
"proprietary": "<string>"
}
}
},
"agent": {
"bic": "DEMOLT1XXXX",
"name": "<string>"
},
"address": {
"country": "LT",
"line": "<string>",
"structured": {
"buildingName": "<string>",
"buildingNumber": "<string>",
"countrySubDivision": "<string>",
"department": "<string>",
"districtName": "<string>",
"floor": "<string>",
"postBox": "<string>",
"postCode": "<string>",
"room": "<string>",
"street": "<string>",
"subDepartment": "<string>",
"townLocationName": "<string>"
},
"town": "Vilnius"
},
"name": "<string>",
"organisationIdentification": {
"otherIdentifications": [
{
"id": "<string>",
"issuer": "<string>",
"scheme": {
"code": "<string>",
"proprietary": "<string>"
}
}
],
"bic": "<string>",
"lei": "<string>"
},
"privateIdentification": {
"otherIdentifications": [
{
"id": "<string>",
"issuer": "<string>",
"scheme": {
"code": "<string>",
"proprietary": "<string>"
}
}
],
"birthInformation": {
"city": "<string>",
"country": "<string>",
"date": "<string>",
"province": "<string>"
}
}
},
"debtor": {
"account": {
"iban": "<string>",
"other": {
"id": "<string>",
"issuer": "<string>",
"scheme": {
"code": "<string>",
"proprietary": "<string>"
}
}
},
"agent": {
"bic": "DEMOLT1XXXX",
"name": "<string>"
},
"address": {
"country": "LT",
"line": "<string>",
"structured": {
"buildingName": "<string>",
"buildingNumber": "<string>",
"countrySubDivision": "<string>",
"department": "<string>",
"districtName": "<string>",
"floor": "<string>",
"postBox": "<string>",
"postCode": "<string>",
"room": "<string>",
"street": "<string>",
"subDepartment": "<string>",
"townLocationName": "<string>"
},
"town": "Vilnius"
},
"name": "<string>",
"organisationIdentification": {
"otherIdentifications": [
{
"id": "<string>",
"issuer": "<string>",
"scheme": {
"code": "<string>",
"proprietary": "<string>"
}
}
],
"bic": "<string>",
"lei": "<string>"
},
"privateIdentification": {
"otherIdentifications": [
{
"id": "<string>",
"issuer": "<string>",
"scheme": {
"code": "<string>",
"proprietary": "<string>"
}
}
],
"birthInformation": {
"city": "<string>",
"country": "<string>",
"date": "<string>",
"province": "<string>"
}
}
},
"direction": "OUTBOUND",
"endToEndId": "<string>",
"id": 10300007,
"instructedAmount": 100,
"instructedCurrency": "EUR",
"metadata": [
"<string>"
],
"scheme": "SEPA_CT",
"sddActionOptions": [
{
"reasons": [
{
"available": true,
"code": "MD06",
"deadline": "2026-10-15T11:15:00+03:00"
}
],
"type": "RETURN",
"deadline": "2026-08-27T11:15:00+03:00",
"settlementDate": "2023-12-25",
"windowEndDate": "2026-12-25"
}
],
"sddRejectWindowExpired": true,
"sddReturnWindowsExpired": true,
"settlementAmount": 100,
"settlementCurrency": "EUR",
"status": "COMPLETED",
"type": "PAYMENT",
"adjustmentDisplayParties": {
"creditor": {
"account": "<string>",
"bic": "<string>",
"name": "<string>"
},
"debtor": {
"account": "<string>",
"bic": "<string>",
"name": "<string>"
}
},
"categoryPurposeCode": "BONU",
"categoryPurposeProprietary": "<string>",
"chargesAndAdjustments": {
"compensation": 25,
"returnCharges": 50,
"unaccountedTax": 123
},
"creditTransferType": "CUSTOMER",
"directDebit": {
"amendmentIndicator": true,
"amendmentInformationDetails": {
"originalCreditorSchemeId": "<string>",
"originalDebtorAccount": "<string>",
"originalMandateId": "<string>"
},
"esignature": "<string>",
"mandateId": "MANDATE-2026-001",
"sequenceType": "RCUR",
"signatureDate": "2026-01-15"
},
"instructionId": "<string>",
"messageId": "<string>",
"originBic": "<string>",
"originName": "<string>",
"originReasonCode": "AC04",
"originReasonInfo": "<string>",
"parentPaymentId": 123,
"parentTransactionAmount": 123,
"purpose": "Invoice #12345",
"purposeCode": "<string>",
"settlementDate": "2023-12-25",
"statusReason": {
"code": "ACSC",
"message": "Accepted settlement completed"
},
"structuredReference": {
"issuer": "ISO",
"reference": "RF123456"
},
"swift": {
"businessMessageId": "BIZ-MSG-001",
"charges": {
"items": [
{
"amount": 50,
"currency": "EUR",
"bic": "<string>"
}
],
"bearer": "SHAR"
},
"messageDefinition": "pacs.008.001.08",
"receiverBic": "<string>",
"senderBic": "<string>",
"settlementAccount": {
"currency": "EUR",
"iban": "<string>",
"other": {
"id": "<string>",
"issuer": "<string>",
"scheme": {
"code": "<string>",
"proprietary": "<string>"
}
}
},
"settlementMethod": "INDA",
"uetr": "<string>"
},
"t2": {
"priority": "HIGH",
"uetr": "a1b2c3d4-1111-4222-8333-000000000001"
},
"ultimateCreditor": {
"name": "<string>",
"organisationIdentification": {
"otherIdentifications": [
{
"id": "<string>",
"issuer": "<string>",
"scheme": {
"code": "<string>",
"proprietary": "<string>"
}
}
],
"bic": "<string>",
"lei": "<string>"
},
"privateIdentification": {
"otherIdentifications": [
{
"id": "<string>",
"issuer": "<string>",
"scheme": {
"code": "<string>",
"proprietary": "<string>"
}
}
],
"birthInformation": {
"city": "<string>",
"country": "<string>",
"date": "<string>",
"province": "<string>"
}
}
},
"ultimateDebtor": {
"name": "<string>",
"organisationIdentification": {
"otherIdentifications": [
{
"id": "<string>",
"issuer": "<string>",
"scheme": {
"code": "<string>",
"proprietary": "<string>"
}
}
],
"bic": "<string>",
"lei": "<string>"
},
"privateIdentification": {
"otherIdentifications": [
{
"id": "<string>",
"issuer": "<string>",
"scheme": {
"code": "<string>",
"proprietary": "<string>"
}
}
],
"birthInformation": {
"city": "<string>",
"country": "<string>",
"date": "<string>",
"province": "<string>"
}
}
},
"updatedAt": "2025-11-21T12:46:54.612954Z"
}{
"code": "<string>",
"data": {
"errors": [
{
"code": "<string>",
"field_name": "<string>",
"message": "<string>",
"value": "<string>"
}
],
"message": "<string>"
},
"message": "<string>"
}Payment Information
Get payment
Returns the full payment details for any scheme - parties, amounts, references and the current status with its reason.
GET
/
v3
/
payments
/
{id}
Get payment by ID
curl --request GET \
--url https://api.pgw-sandbox.finventi.com/v3/payments/{id}import requests
url = "https://api.pgw-sandbox.finventi.com/v3/payments/{id}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.pgw-sandbox.finventi.com/v3/payments/{id}', 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/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$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/{id}"
req, _ := http.NewRequest("GET", url, nil)
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/{id}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pgw-sandbox.finventi.com/v3/payments/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"createdAt": "2025-11-21T12:46:54.321667Z",
"creditor": {
"account": {
"iban": "<string>",
"other": {
"id": "<string>",
"issuer": "<string>",
"scheme": {
"code": "<string>",
"proprietary": "<string>"
}
}
},
"agent": {
"bic": "DEMOLT1XXXX",
"name": "<string>"
},
"address": {
"country": "LT",
"line": "<string>",
"structured": {
"buildingName": "<string>",
"buildingNumber": "<string>",
"countrySubDivision": "<string>",
"department": "<string>",
"districtName": "<string>",
"floor": "<string>",
"postBox": "<string>",
"postCode": "<string>",
"room": "<string>",
"street": "<string>",
"subDepartment": "<string>",
"townLocationName": "<string>"
},
"town": "Vilnius"
},
"name": "<string>",
"organisationIdentification": {
"otherIdentifications": [
{
"id": "<string>",
"issuer": "<string>",
"scheme": {
"code": "<string>",
"proprietary": "<string>"
}
}
],
"bic": "<string>",
"lei": "<string>"
},
"privateIdentification": {
"otherIdentifications": [
{
"id": "<string>",
"issuer": "<string>",
"scheme": {
"code": "<string>",
"proprietary": "<string>"
}
}
],
"birthInformation": {
"city": "<string>",
"country": "<string>",
"date": "<string>",
"province": "<string>"
}
}
},
"debtor": {
"account": {
"iban": "<string>",
"other": {
"id": "<string>",
"issuer": "<string>",
"scheme": {
"code": "<string>",
"proprietary": "<string>"
}
}
},
"agent": {
"bic": "DEMOLT1XXXX",
"name": "<string>"
},
"address": {
"country": "LT",
"line": "<string>",
"structured": {
"buildingName": "<string>",
"buildingNumber": "<string>",
"countrySubDivision": "<string>",
"department": "<string>",
"districtName": "<string>",
"floor": "<string>",
"postBox": "<string>",
"postCode": "<string>",
"room": "<string>",
"street": "<string>",
"subDepartment": "<string>",
"townLocationName": "<string>"
},
"town": "Vilnius"
},
"name": "<string>",
"organisationIdentification": {
"otherIdentifications": [
{
"id": "<string>",
"issuer": "<string>",
"scheme": {
"code": "<string>",
"proprietary": "<string>"
}
}
],
"bic": "<string>",
"lei": "<string>"
},
"privateIdentification": {
"otherIdentifications": [
{
"id": "<string>",
"issuer": "<string>",
"scheme": {
"code": "<string>",
"proprietary": "<string>"
}
}
],
"birthInformation": {
"city": "<string>",
"country": "<string>",
"date": "<string>",
"province": "<string>"
}
}
},
"direction": "OUTBOUND",
"endToEndId": "<string>",
"id": 10300007,
"instructedAmount": 100,
"instructedCurrency": "EUR",
"metadata": [
"<string>"
],
"scheme": "SEPA_CT",
"sddActionOptions": [
{
"reasons": [
{
"available": true,
"code": "MD06",
"deadline": "2026-10-15T11:15:00+03:00"
}
],
"type": "RETURN",
"deadline": "2026-08-27T11:15:00+03:00",
"settlementDate": "2023-12-25",
"windowEndDate": "2026-12-25"
}
],
"sddRejectWindowExpired": true,
"sddReturnWindowsExpired": true,
"settlementAmount": 100,
"settlementCurrency": "EUR",
"status": "COMPLETED",
"type": "PAYMENT",
"adjustmentDisplayParties": {
"creditor": {
"account": "<string>",
"bic": "<string>",
"name": "<string>"
},
"debtor": {
"account": "<string>",
"bic": "<string>",
"name": "<string>"
}
},
"categoryPurposeCode": "BONU",
"categoryPurposeProprietary": "<string>",
"chargesAndAdjustments": {
"compensation": 25,
"returnCharges": 50,
"unaccountedTax": 123
},
"creditTransferType": "CUSTOMER",
"directDebit": {
"amendmentIndicator": true,
"amendmentInformationDetails": {
"originalCreditorSchemeId": "<string>",
"originalDebtorAccount": "<string>",
"originalMandateId": "<string>"
},
"esignature": "<string>",
"mandateId": "MANDATE-2026-001",
"sequenceType": "RCUR",
"signatureDate": "2026-01-15"
},
"instructionId": "<string>",
"messageId": "<string>",
"originBic": "<string>",
"originName": "<string>",
"originReasonCode": "AC04",
"originReasonInfo": "<string>",
"parentPaymentId": 123,
"parentTransactionAmount": 123,
"purpose": "Invoice #12345",
"purposeCode": "<string>",
"settlementDate": "2023-12-25",
"statusReason": {
"code": "ACSC",
"message": "Accepted settlement completed"
},
"structuredReference": {
"issuer": "ISO",
"reference": "RF123456"
},
"swift": {
"businessMessageId": "BIZ-MSG-001",
"charges": {
"items": [
{
"amount": 50,
"currency": "EUR",
"bic": "<string>"
}
],
"bearer": "SHAR"
},
"messageDefinition": "pacs.008.001.08",
"receiverBic": "<string>",
"senderBic": "<string>",
"settlementAccount": {
"currency": "EUR",
"iban": "<string>",
"other": {
"id": "<string>",
"issuer": "<string>",
"scheme": {
"code": "<string>",
"proprietary": "<string>"
}
}
},
"settlementMethod": "INDA",
"uetr": "<string>"
},
"t2": {
"priority": "HIGH",
"uetr": "a1b2c3d4-1111-4222-8333-000000000001"
},
"ultimateCreditor": {
"name": "<string>",
"organisationIdentification": {
"otherIdentifications": [
{
"id": "<string>",
"issuer": "<string>",
"scheme": {
"code": "<string>",
"proprietary": "<string>"
}
}
],
"bic": "<string>",
"lei": "<string>"
},
"privateIdentification": {
"otherIdentifications": [
{
"id": "<string>",
"issuer": "<string>",
"scheme": {
"code": "<string>",
"proprietary": "<string>"
}
}
],
"birthInformation": {
"city": "<string>",
"country": "<string>",
"date": "<string>",
"province": "<string>"
}
}
},
"ultimateDebtor": {
"name": "<string>",
"organisationIdentification": {
"otherIdentifications": [
{
"id": "<string>",
"issuer": "<string>",
"scheme": {
"code": "<string>",
"proprietary": "<string>"
}
}
],
"bic": "<string>",
"lei": "<string>"
},
"privateIdentification": {
"otherIdentifications": [
{
"id": "<string>",
"issuer": "<string>",
"scheme": {
"code": "<string>",
"proprietary": "<string>"
}
}
],
"birthInformation": {
"city": "<string>",
"country": "<string>",
"date": "<string>",
"province": "<string>"
}
}
},
"updatedAt": "2025-11-21T12:46:54.612954Z"
}{
"code": "<string>",
"data": {
"errors": [
{
"code": "<string>",
"field_name": "<string>",
"message": "<string>",
"value": "<string>"
}
],
"message": "<string>"
},
"message": "<string>"
}Overview
Returns the complete v3 representation of a single payment, for every scheme (SEPA, INST, SDD, SWIFT, T2). Use it after a webhook to load everything about the payment - the webhook carries only the status change; this endpoint returns the full picture:
- Parties - debtor and creditor with name, account (IBAN or other), agent BIC, full postal address, private/organisation identification, plus ultimate debtor and creditor when present
- Amounts - instructed and settlement amount with currencies, settlement date, charges and adjustments (return charges, compensation, unaccounted tax)
- References -
endToEndId,messageId,instructionId, purpose, purpose code, category purpose, structured reference - Status - current
statustogether withstatusReason(code+message) explaining why the payment is in that status, and the originator of the last status change (originBic,originName,originReasonCode,originReasonInfo) - Scheme-specific blocks -
swift,directDebitort2details when the payment belongs to that scheme - Links -
parentPaymentIdconnects returns and cancellations to the original payment
When to use it
- Correlate a Payment Status Change webhook by
trx_id, then fetch the details you need - Investigate a
Rejectedpayment -statusReasonand theorigin*fields identify the reason and which party rejected it - Reconcile a received payment - full payer details and references arrive exactly as sent by the counterparty
Path Parameters
Response
Payment found and returned successfully
Time and date when the payment was created (UTC)
Example:
"2025-11-21T12:46:54.321667Z"
Creditor (recipient) party information
Show child attributes
Show child attributes
Debtor (sender) party information
Show child attributes
Show child attributes
Payment direction
Available options:
OUTBOUND, INBOUND Example:
"OUTBOUND"
End-to-end identifier assigned by the originator
Unique payment identifier
Example:
10300007
Instructed payment amount in minor currency units (cents)
Example:
100
Instructed payment currency ISO code
Example:
"EUR"
Client-defined metadata values assigned when the payment was created
Payment scheme. SEPA_CT — SEPA Credit Transfer, SEPA_INST — SEPA Instant Credit Transfer, SEPA_DD — SEPA Direct Debit, SWIFT — SWIFT cross-border payment.
Available options:
SEPA_CT, SEPA_INST, SEPA_DD, SWIFT, T2 Example:
"SEPA_CT"
R-transactions a client may raise against this payment right now. Empty for anything but a received SEPA direct debit collection. The action endpoints validate these windows again when a request is submitted.
Show child attributes
Show child attributes
True only when all Reject reason windows have expired. False also covers unknown expiry.
True only when all Return and Refund reason windows have expired. False also covers unknown expiry.
Settlement amount in minor currency units (cents)
Example:
100
Settlement currency ISO code
Example:
"EUR"
Current payment status
Available options:
CREATED, TO_SIGN, SIGNED, SENT_TO_CLEAR, COMPLETED, CANCELLED, REJECTED, ACCEPTED, SOME_PROBLEMS, PENDING_CONFIRMATION Example:
"COMPLETED"
Payment type
Available options:
PAYMENT, PAYMENT_CANCELLATION, PAYMENT_RETURN, REVERSE_PAYMENT, CSM_FEES, ADJUSTMENT Example:
"PAYMENT"
Display-only parties for a resolved liquidity adjustment; the authoritative parties remain in debtor and creditor
Show child attributes
Show child attributes
Category purpose code (e.g. SALA, TAXS, GOVT)
Available options:
BONU, CASH, CBLK, CCRD, CORT, DCRD, DIVI, DVPM, EPAY, FCIN, FCOL, GOVT, HEDG, ICCP, IDCP, INTC, INTE, LOAN, MP2B, MP2P, OTHR, PENS, RPRE, RRCT, RVPM, SALA, SECU, SSBE, SUPP, TAXS, TRAD, TREA, VATX, WHLD Proprietary category purpose
Return-only charges and adjustments. Populated only for payment_return / payment_cancellation transactions; absent otherwise.
Show child attributes
Show child attributes
Credit transfer type for T2 payments
Available options:
CUSTOMER, FINANCIAL_INSTITUTION SEPA direct debit fields, present only for SDD payments
Show child attributes
Show child attributes
Instruction identifier
Message identifier
Return / rejection originator BIC
Return / rejection originator name
Return / rejection reason code
Example:
"AC04"
Return / rejection reason information
Parent payment identifier, present for returns / reversals / cancellations
Original (parent) transaction amount in minor currency units (cents)
Unstructured remittance information (free text)
Example:
"Invoice #12345"
ISO 20022 purpose code or proprietary purpose value (e.g. SUPP, SALA, TAXS)
Settlement date
Reason for the current status
Show child attributes
Show child attributes
Structured remittance reference
Show child attributes
Show child attributes
SWIFT-specific fields, present only for SWIFT payments
Show child attributes
Show child attributes
T2-specific fields, present only for T2 payments
Show child attributes
Show child attributes
Ultimate creditor party information
Show child attributes
Show child attributes
Ultimate debtor party information
Show child attributes
Show child attributes
Time and date when the payment was last updated (UTC)
Example:
"2025-11-21T12:46:54.612954Z"
Last modified on September 9, 2026