Webhook event

TransactionCreatedEvent

The ExternalTransactionCreatedEvent webhook notifies subscribers when a financial transaction has been successfully created and recorded within the Sodtrack platform.

Sodtrack sends POST with Content-Type: application/json to the endpoint configured for your tenant. See webhooks overview for delivery and security guidance.

Payload

{
  "timestamp": "string",
  "userTriggererEmail": "string",
  "externalTransaction": {
    "createdDate": "Date",
    "id": "number",
    "reference": "string",
    "extraInfo": "string",
    "amount": "number",
    "status": "string",
    "type": "string",
    "currency": {
      "id": "number",
      "name": "string"
    },
    "shoppingCartId": "number",
    "bookingTransactionMovements": [
      {
        "bookingId": "number",
        "bookingReference": "string",
        "currency": {
          "id": "number",
          "name": "string"
        },
        "addonMovement": [
          {
            "addonId": "number",
            "reference": "string",
            "amount": "number",
            "quantityAdjustment": "number"
          }
        ],
        "serviceMovement": {
          "addonId": "number",
          "sku": [
            "string"
          ],
          "amount": "number",
          "quantityAdjustment": "number"
        }
      }
    ],
    "dynamicFormSnapshotFields": [
      {
        "reference": "string",
        "value": "string"
      }
    ]
  }
}

Purpose

The ExternalTransactionCreatedEvent webhook notifies subscribers when a financial transaction has been successfully created and recorded within the Sodtrack platform.

The transaction is recorded with all associated booking and addon movements, enabling comprehensive financial tracking.

Integrating this webhook allows client systems to automatically:

Synchronize payment records,
Trigger financial workflows (e.g., accounting updates, invoice generation, revenue recognition, reconciliation), and
Maintain real-time financial consistency with Sodtrack.

Trigger Condition

This webhook is triggered when:

A financial transaction (payment or refund) is successfully created and validated in the Sodtrack system, and
The transaction is associated with a shopping cart and includes all related booking and addon movements.

Example Use Cases

Automatically synchronize payment and refund records in external accounting systems, ERPs, or financial platforms.
Trigger post-transaction workflows such as invoice generation, receipt delivery, or revenue recognition.
Maintain synchronized financial records between Sodtrack and third-party systems.
Track payment status and reconcile transactions across multiple sources.
Generate financial reports and analytics based on transaction patterns.

Body

Field	Type	Description	Always
createdDate	Date	Date/time when the external transaction was created.	✅
id	number	Unique transaction identifier.	✅
reference	string	Transaction external reference.	❌
extraInfo	string	Additional information or context provided by external system.	❌
amount	number	Transaction amount in the selected currency.	✅
status	string	Current transaction status.	❌
type	string	Transaction type (`payment`	`refund`).
currency.id	number	Currency identifier.	✅
currency.name	string	Currency name.	✅
shoppingCartId	number	Identifier linking the transaction to a shopping cart/stage.	❌

💸 externalTransaction.bookingTransactionMovements[]

	Type	Description	Always
bookingId	number	Affected booking identifier.	✅
bookingReference	string	Booking external reference.	❌
currency.id	number	Currency identifier for this movement.	❌
currency.name	string	Currency name for this movement.	❌

🔹 bookingTransactionMovements[].addonMovement[] (optional array)

Field	Type	Description	Always
addonId	number	Identifier of the add-on affected.	❌
reference	string	Add-on external reference.	❌
amount	number	Monetary adjustment affecting this add-on.	❌
quantityAdjustment	number	Added/removed add-on units.	❌

🔹 bookingTransactionMovements[].serviceMovement (optional)

	Type	Description	Always
addonId	number	Identifier of the service variant addon (if applicable).	❌
sku	string[]	SKUs associated with the service movement.	❌
amount	number	Monetary adjustment affecting the service.	❌
quantityAdjustment	number	Added/removed service quantity.	❌

📝 externalTransaction.dynamicFormSnapshotFields[]

Field	Type	Description	Always
reference	string	Dynamic field external reference.	❌
value	string	Captured value at the moment of the transaction.	❌