> ## 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.

# Transaction Executed

> Webhook notification sent when a transaction is successfully executed

<Note>
  This webhook is sent when a transaction has been successfully executed in the ledger.
</Note>

## Webhook Structure

<ParamField body="id" type="string (UUID)" required>
  Unique identifier for this event
</ParamField>

<ParamField body="time" type="string (ISO 8601)" required>
  Timestamp of when the event occurred
</ParamField>

<ParamField body="correlationId" type="string">
  Identifier to correlate the request with the response. Present only for client-initiated transactions.
</ParamField>

<ParamField body="type" type="string" required>
  The type of event. Value: `transaction.executed`
</ParamField>

<ParamField body="data" type="object" required>
  The event data containing the details below
</ParamField>

### Data Fields

<ParamField body="data.referenceId" type="string" required>
  Reference identifier linking transaction to its origin (e.g., payment identification)
</ParamField>

<ParamField body="data.referenceSource" type="string" required>
  Source system that initiated the transaction. Available values: `PAYMENT`, `CLIENT`, `PLAIS`, `PAYMENT_CARD`
</ParamField>

<ParamField body="data.transactionId" type="string (UUID)" required>
  Unique identifier of the executed transaction
</ParamField>

<ParamField body="data.ledgerTransactionId" type="integer" required>
  Identifier of the transaction in the ledger system
</ParamField>

<ParamField body="data.postings" type="array" required>
  List of postings (debits and credits) that make up the transaction

  <Expandable title="Posting object properties">
    <ParamField body="id" type="string (UUID)" required>
      Unique identifier of the posting
    </ParamField>

    <ParamField body="source" type="string" required>
      Address of the source ledger account from which funds are debited
    </ParamField>

    <ParamField body="sourceBalanceAfter" type="integer" required>
      Balance of the source account after the posting, in minor units (cents)
    </ParamField>

    <ParamField body="destination" type="string" required>
      Address of the destination ledger account to which funds are credited
    </ParamField>

    <ParamField body="destinationBalanceAfter" type="integer" required>
      Balance of the destination account after the posting, in minor units (cents)
    </ParamField>

    <ParamField body="amount" type="integer" required>
      Transaction amount in minor units (cents)
    </ParamField>

    <ParamField body="currency" type="string" required>
      Currency code (ISO 4217). Available values: `EUR`
    </ParamField>

    <ParamField body="details" type="string" required>
      Description or reason for the posting
    </ParamField>

    <ParamField body="type" type="string" required>
      Posting type. Available values: `CREDIT_TRANSFER`, `FEES`
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="data.createdAt" type="string (ISO 8601)" required>
  Timestamp when the transaction was created
</ParamField>

## Request Example

```json theme={null}
{
  "id": "a3f8e2b1-5c7d-4e9f-b8a2-1d4c6e9f0a3b",
  "time": "2025-01-15T10:30:00Z",
  "correlationId": "550e8400-e29b-41d4-a716-446655440000",
  "type": "transaction.executed",
  "data": {
    "referenceId": "PAY-123456",
    "referenceSource": "PAYMENT",
    "transactionId": "019bdb2a-960f-789d-8955-21720e6cdeed",
    "ledgerTransactionId": 12345,
    "postings": [
      {
        "id": "c1d2e3f4-5a6b-7c8d-9e0f-1a2b3c4d5e6f",
        "source": "CUSTOMER:019bdb2a-960f-789d-8955-21720e6cdeee:019bdb2a-960f-789d-8955-21720e6cdeed:CURRENT",
        "sourceBalanceAfter": 490000,
        "destination": "INTERNAL:CLEARING:OUTBOUND",
        "destinationBalanceAfter": 10000,
        "amount": 10000,
        "currency": "EUR",
        "details": "Payment for invoice #12345",
        "type": "CREDIT_TRANSFER"
      },
      {
        "id": "d2e3f4a5-6b7c-8d9e-0f1a-2b3c4d5e6f7a",
        "source": "CUSTOMER:019bdb2a-960f-789d-8955-21720e6cdeee:019bdb2a-960f-789d-8955-21720e6cdeed:CURRENT",
        "sourceBalanceAfter": 489900,
        "destination": "INTERNAL:CLEARING:FEES",
        "destinationBalanceAfter": 100,
        "amount": 100,
        "currency": "EUR",
        "details": "Fees for invoice #12345",
        "type": "FEES"
      }
    ],
    "createdAt": "2024-01-15T10:30:00.000Z"
  }
}
```