Transaction Event

Overview

The Transaction webhook event is triggered when a transaction is created or its status changes. Transactions are generated from financial activities and are assigned a specific Status depending on its progress.

A Transaction can have one the following statuses at a given time:

• Pending
• Failed
• Settled

To configure a Transaction webhook subscription, reference the Webhook Configuration page.

Event Payload Structure

When a Transaction event occurs, Noah sends a webhook notification to your configured endpoint with the following JSON Payload; some objects within this are optional depending on the usage from which the transaction was created.

• FiatPayment - this object is included if there is a fiat payment method attributed to the transaction.
• Orchestration - this object is included if the transaction is a result of a Rule execution.
• Breakdown - list explaining how the transaction amount should be split
• AdjustmentFor - this object is included if the transaction was created to adjust an earlier transaction.

{
  "Data": {
    "ID": "123e4567-e89b-12d3-a456-426614174000",
    "PublicID": "TX1234567890",
    "Network": "Bitcoin",
    "Created": "2024-04-16T08:00:55Z",
    "Status": "Settled",
    "Direction": "In",
    "CustomerID": "550e8400-e29b-41d4-a716-446655440000",
    "ExternalID": "EXT123456",
    "Amount": "12.3",
    "Breakdown": [
      {
        "Amount": "0.1",
        "Type": "BusinessFee"
      },
      {
        "Amount": "12.29",
        "Type": "Remaining"
      }
    ],
    "NetworkFee": "0.0001",
    "CryptoCurrency": "BTC",
    "FiatPayment": {
      "Amount": "5000.00",
      "FeeAmount": "50.00",
      "Rate": "49500.00",
      "FiatCurrency": "USD",
      "FiatDepositID": "e1583a74-ab77-583a-ad2f-1c47617d514b",
      "PaymentSystemID": "20250502CHASUS33000123"
    },
    "Orchestration": {
      "RuleID": "RULE123",
      "RuleExecutionID": "EXEC123"
    },
    "AdjustmentFor": {
      "AdjustedTransactionID": "938235a3-3b56-5c8a-aa81-31f57c503d91",
      "AdjustmentID": "39e3b3a5-cac9-5c41-97fc-d4219669451f",
      "Reason": "ExchangeRateCorrection"
    }
  },
  "EventType": "Transaction",
  "EventVersion": 1730205262722,
  "Occurred": "2024-10-29T12:34:23Z",
  "UserID": "ory|jfu84hr7-2228-4j2c-fu0e-fu555bre38p9"
}