Skip to main content
POST
/
v3
/
payments
/
{transactionId}
/
investigations
Create investigation
curl --request POST \
  --url https://api.pgw-sandbox.finventi.com/v3/payments/{transactionId}/investigations \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "type": "CLAIM_NON_RECEIPT",
  "claimNonReceiptDetails": {
    "additionalInfo": "<string>"
  }
}
'
{
  "createdAt": "2023-11-07T05:31:56Z",
  "createdBy": "<string>",
  "direction": "OUTBOUND",
  "id": 123,
  "messageId": "<string>",
  "schema": "SEPA",
  "status": "PENDING",
  "type": "CLAIM_NON_RECEIPT",
  "claimNonReceiptDetails": {
    "additionalInfo": "<string>",
    "caseId": "<string>"
  },
  "delivery": {
    "status": "<string>",
    "statusReason": "<string>"
  },
  "referencedTransactionId": 123,
  "resolution": {
    "confirmationCode": "ACNR",
    "messageId": "<string>",
    "rejectionReasonCode": "<string>",
    "settlementDate": "2023-12-25"
  },
  "statusHistory": [
    {
      "createdAt": "2023-11-07T05:31:56Z",
      "createdBy": "<string>",
      "statusTo": "PENDING",
      "changeReason": "<string>",
      "statusFrom": "PENDING"
    }
  ],
  "transactionDetails": {
    "amount": 123,
    "currencyCode": "<string>",
    "endToEndId": "<string>",
    "method": "SEPA",
    "settlementDate": "2023-12-25",
    "creditorBic": "<string>",
    "creditorIban": "<string>",
    "creditorName": "<string>",
    "debtorBic": "<string>",
    "debtorIban": "<string>",
    "debtorName": "<string>",
    "remittanceInfo": "<string>"
  },
  "updatedAt": "2023-11-07T05:31:56Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.finventi.com/llms.txt

Use this file to discover all available pages before exploring further.

This API is in preview and subject to change.

Idempotent Endpoint

This endpoint supports idempotency to prevent duplicate investigations.

How to Use

  • Include an Idempotency-Key header with a unique value (UUID recommended)
  • The API returns the existing investigation when you reuse the same key
  • Retry requests safely without creating duplicates

Investigation Types

Claim Non-Receipt (camt.027)

  • For outbound SEPA CT payments in COMPLETED status
  • Requires additionalInfo in the request body

Payment Status Request (pacs.028)

  • For outbound SEPA INST payments in SENT_TO_CLEAR status
  • additionalInfo must not be provided

Headers

Idempotency-Key
string
required

Unique identifier to ensure idempotent investigation creation

Path Parameters

transactionId
integer<int64>
required

Payment transaction ID

Body

application/json
type
enum<string>
required

Investigation type: CLAIM_NON_RECEIPT (camt.027) or PAYMENT_STATUS_REQUEST (pacs.028)

Available options:
CLAIM_NON_RECEIPT,
PAYMENT_STATUS_REQUEST
claimNonReceiptDetails
object

Claim non-receipt details, required when type is CLAIM_NON_RECEIPT

Response

Investigation created

createdAt
string<date-time>
required

Timestamp when the investigation was created

createdBy
string
required

User or system that created the investigation

direction
enum<string>
required

Investigation direction (INBOUND or OUTBOUND)

Available options:
OUTBOUND,
INBOUND
id
integer<int64>
required

Investigation ID

messageId
string
required

Investigation message ID

schema
enum<string>
required

Message schema identifier

Available options:
SEPA,
INST
status
enum<string>
required

New investigation status

Available options:
PENDING,
RESOLVED,
REJECTED
type
enum<string>
required

Investigation type: CLAIM_NON_RECEIPT (camt.027) or PAYMENT_STATUS_REQUEST (pacs.028)

Available options:
CLAIM_NON_RECEIPT,
PAYMENT_STATUS_REQUEST
claimNonReceiptDetails
object

Claim non-receipt investigation details, present for CLAIM_NON_RECEIPT type

delivery
object

Investigation message delivery status information from CSM

referencedTransactionId
integer<int64>

Referenced transaction ID

resolution
object

Resolution details, present when the investigation has been resolved

statusHistory
object[]

Investigation status change history, included when retrieving a single investigation

transactionDetails
object

Original transaction details referenced by the investigation

updatedAt
string<date-time>

Timestamp when the investigation was last updated

Last modified on March 19, 2026