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>",
    "resolution": {
      "confirmationCode": "ACNR",
      "messageId": "<string>",
      "rejectionReasonCode": "<string>",
      "settlementDate": "2023-12-25"
    }
  },
  "delivery": {
    "status": "<string>",
    "statusReason": "<string>"
  },
  "referencedTransactionId": 123,
  "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"
}
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

​
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