# Transaction and Statement Webhooks (https://docs.tryacme.com/reference/webhooks-transactions)

> For AI agents: the documentation index is at [llms.txt](https://docs.tryacme.com/llms.txt), with every page in one file at [llms-full.txt](https://docs.tryacme.com/llms-full.txt). Each page is also available as Markdown by appending `.md` to its URL.

Example webhook bodies for transactions.created and statements.created.

See [how to read the webhook examples](https://docs.tryacme.com/guides/webhook-examples). The values are made up, but every
field, its order and its format match what Acme sends.

## Transactions [#transactions]

A credit or debit was reported on one of your bank accounts. The event is `transactions.created`.

<CodeBlockTabs defaultValue="Singapore (DBS)">
  <CodeBlockTabsList>
    <CodeBlockTabsTrigger value="Singapore (DBS)">
      Singapore (DBS)
    </CodeBlockTabsTrigger>

    <CodeBlockTabsTrigger value="Malaysia (UOB)">
      Malaysia (UOB)
    </CodeBlockTabsTrigger>

    <CodeBlockTabsTrigger value="Hong Kong (SCB)">
      Hong Kong (SCB)
    </CodeBlockTabsTrigger>

    <CodeBlockTabsTrigger value="UAE (Zand)">
      UAE (Zand)
    </CodeBlockTabsTrigger>
  </CodeBlockTabsList>

  <CodeBlockTab value="Singapore (DBS)">
    ```json
    {
      "id": "wbh_0RWF7FQ99Y6AR",
      "createdAt": "2026-10-08T03:14:07.429871266Z",
      "mode": "LIVE",
      "event": "transactions.created",
      "object": {
        "id": "txn_0RWF7FQ81Y5NH",
        "dataSource": "ICN",
        "transactionType": "PAYNOW",
        "transactionStatus": "BOOKED",
        "bankReference": "IMB2628103140726100000C741000000126",
        "transactionReferences": [
          {
            "dataSource": "ICN",
            "name": "msgId",
            "value": "IMB2628103140726100000C741000000126"
          }
        ],
        "description": "INV-2026-10-0412",
        "customerReference": "INV-2026-10-0412",
        "remittanceInformation": null,
        "additionalInformation": null,
        "amount": 128050,
        "currency": "SGD",
        "direction": "CREDIT",
        "counterparty": {
          "name": "TAN WEI MING",
          "bank": "OCBCSGSGXXX",
          "bankAccountNumber": "5012846731"
        },
        "bankAccount": {
          "id": "intacc_0RWF7FPY9Y4WK",
          "bank": "DBSSSGSGXXX",
          "bankAccountNumber": "0721845093"
        },
        "virtualAccountNumber": null,
        "transactionDate": "2026-10-08",
        "bookingDate": {
          "date": "2026-10-08",
          "time": null,
          "offset": null,
          "tz": null
        },
        "statementId": null,
        "createdAt": "2026-10-08T03:14:07.418Z",
        "updatedAt": "2026-10-08T03:14:07.418Z"
      }
    }
    ```
  </CodeBlockTab>

  <CodeBlockTab value="Malaysia (UOB)">
    ```json
    {
      "id": "wbh_0RWF7FRMSY74F",
      "createdAt": "2026-10-08T03:22:51.219443871Z",
      "mode": "LIVE",
      "event": "transactions.created",
      "object": {
        "id": "txn_0RWF7FRMSY74E",
        "dataSource": "ICN",
        "transactionType": "DUITNOW",
        "bankReference": null,
        "transactionReferences": null,
        "description": null,
        "customerReference": "Order 88213",
        "remittanceInformation": null,
        "additionalInformation": "{\"transactionDescription\":\"DuitNow/Instant Trf\"}",
        "amount": 45000,
        "currency": "MYR",
        "direction": "CREDIT",
        "counterparty": {
          "name": "MBB AHMAD BIN HASSAN",
          "bank": null,
          "bankAccountNumber": null
        },
        "bankAccount": {
          "id": "intacc_0RWF7FRAXY686",
          "bank": "UOVBMYKLXXX",
          "bankAccountNumber": "2213018475"
        },
        "virtualAccountNumber": null,
        "transactionDate": "2026-10-08",
        "statementId": null,
        "createdAt": "2026-10-08T03:22:51.207Z",
        "updatedAt": "2026-10-08T03:22:51.207Z"
      }
    }
    ```
  </CodeBlockTab>

  <CodeBlockTab value="Hong Kong (SCB)">
    ```json
    {
      "id": "wbh_0RWF7GXMGEP40",
      "createdAt": "2026-10-08T06:26:55.744190372Z",
      "mode": "LIVE",
      "event": "transactions.created",
      "object": {
        "id": "txn_0RWF7GXCGEP36",
        "dataSource": "ICN",
        "transactionType": "FPS",
        "transactionStatus": "BOOKED",
        "bankReference": "FRN20261008PAYC0108416372915",
        "transactionReferences": [
          {
            "dataSource": "ICN",
            "name": "EndToEndId",
            "value": "HKINV20261008"
          },
          {
            "dataSource": "ICN",
            "name": "ClearingSystemReference",
            "value": "FRN20261008PAYC0108416372915"
          },
          {
            "dataSource": "ICN",
            "name": "transactionCode",
            "value": "FC5"
          },
          {
            "dataSource": "ICN",
            "name": "baiCode",
            "value": "399"
          },
          {
            "dataSource": "ICN",
            "name": "TransactionIdentifier",
            "value": "7612048839100004418"
          },
          {
            "dataSource": "ICN",
            "name": "ExternalIdentifier",
            "value": "HKINV20261008"
          }
        ],
        "description": null,
        "customerReference": "HKINV20261008",
        "remittanceInformation": "IBFT | HKINV20261008\nCHAN TAI MAN | BANK OF EAST ASIA\nFRN20261008PAYC0108416372915\n\n01551200837410 | 015\nHKD | 16400.00\n\n\n\n\n\n\n",
        "additionalInformation": "CHAN TAI MAN 1008PAYC0108416372915",
        "amount": 1640000,
        "currency": "HKD",
        "direction": "CREDIT",
        "counterparty": {
          "name": "CHAN TAI MAN",
          "bank": "BEASHKHHXXX",
          "bankName": "The Bank of East Asia, Ltd.",
          "localRoutingIdentifier": "015",
          "bankAccountNumber": "01551200837410"
        },
        "bankAccount": {
          "id": "intacc_0RWF7GPJ4EN40",
          "bank": "SCBLHKHHXXX",
          "bankAccountNumber": "447120983561"
        },
        "virtualAccountNumber": null,
        "transactionDate": "2026-10-08",
        "statementId": null,
        "createdAt": "2026-10-08T06:26:55.731Z",
        "updatedAt": "2026-10-08T06:26:55.731Z"
      }
    }
    ```
  </CodeBlockTab>

  <CodeBlockTab value="UAE (Zand)">
    ```json
    {
      "id": "wbh_0RWF7FRNSY4YK",
      "createdAt": "2026-10-08T07:41:10.551208337Z",
      "mode": "LIVE",
      "event": "transactions.created",
      "object": {
        "id": "txn_0RWF7FRNDY7Q5",
        "dataSource": "ICN",
        "transactionType": "IBFT",
        "transactionStatus": "BOOKED",
        "bankReference": "D726101007384321",
        "transactionReferences": [
          {
            "dataSource": "ICN",
            "name": "channelRefId",
            "value": "D726101007384321"
          },
          {
            "dataSource": "ICN",
            "name": "instructionIdentification",
            "value": "5d3c1e7a-0b42-4f7e-9c11-2a64b7e0d913"
          }
        ],
        "description": "Invoice 2026-118 consulting fees",
        "customerReference": "5d3c1e7a-0b42-4f7e-9c11-2a64b7e0d913",
        "remittanceInformation": "INV2026118",
        "additionalInformation": "Invoice 2026-118 consulting fees",
        "amount": 1875000,
        "currency": "AED",
        "direction": "CREDIT",
        "counterparty": {
          "name": "GULF TRADING LLC",
          "bank": null,
          "bankAccountNumber": "AE460330000010012345678"
        },
        "bankAccount": {
          "id": "intacc_0RWF7FRNDY7Q3",
          "bank": "ZANDAEAAXXX",
          "bankAccountNumber": "AE070960000691060008301"
        },
        "virtualAccountNumber": null,
        "transactionDate": "2026-10-08",
        "bookingDate": {
          "date": "2026-10-08",
          "time": "11:41:09.000",
          "offset": "+04:00",
          "tz": null
        },
        "statementId": null,
        "createdAt": "2026-10-08T07:41:10.538Z",
        "updatedAt": "2026-10-08T07:41:10.538Z"
      }
    }
    ```
  </CodeBlockTab>
</CodeBlockTabs>

These fields are left out when the bank does not report them:

* `transactionStatus`
* `bookingDate`, which is also left out when your organization is set up to hide it
* `currencyExchange`, which is sent only for a transaction converted between currencies
* `counterparty.bankName` and `counterparty.localRoutingIdentifier`

What the bank reports also differs:

* `counterparty` can hold only a name, or be `null`, when the bank sends no counterparty details.
* `transactionReferences` lists every reference the bank sent, by the bank's own field name. It can
  be empty or `null` when the bank sent none.

Intraday statement with several new transactions. DBS sends up to 10 transactions in one webhook:

```json
{
  "id": "wbh_0RWF7FRP1Y5E0",
  "createdAt": "2026-10-08T06:05:13.002117954Z",
  "mode": "LIVE",
  "event": "transactions.created",
  "objects": [
    {
      "id": "txn_0RWF7FRNXY54A",
      "dataSource": "CAMT052",
      "transactionType": "GIRO",
      "transactionStatus": "BOOKED",
      "bankReference": "GIRO2610080012784",
      "transactionReferences": [
        {
          "dataSource": "CAMT052",
          "name": "acctSvcrRef",
          "value": "GIRO2610080012784"
        }
      ],
      "description": "GIRO COLLECTION OCT 2026",
      "customerReference": "SUB-OCT26-00187",
      "remittanceInformation": null,
      "additionalInformation": "GIRO COLLECTION OCT 2026",
      "amount": 8900,
      "currency": "SGD",
      "direction": "CREDIT",
      "counterparty": {
        "name": "LIM HUI LING",
        "bank": "UOVBSGSGXXX",
        "bankAccountNumber": "3609127745"
      },
      "bankAccount": {
        "id": "intacc_0RWF7FPY9Y4WK",
        "bank": "DBSSSGSGXXX",
        "bankAccountNumber": "0721845093"
      },
      "virtualAccountNumber": null,
      "transactionDate": "2026-10-08",
      "bookingDate": {
        "date": "2026-10-08",
        "time": null,
        "offset": null,
        "tz": null
      },
      "statementId": null,
      "createdAt": "2026-10-08T06:05:12.844Z",
      "updatedAt": "2026-10-08T06:05:12.844Z"
    },
    {
      "id": "txn_0RWF7FRP1Y5DZ",
      "dataSource": "CAMT052",
      "transactionType": "TT",
      "transactionStatus": "BOOKED",
      "bankReference": "FT2610081142867",
      "transactionReferences": [
        {
          "dataSource": "CAMT052",
          "name": "acctSvcrRef",
          "value": "FT2610081142867"
        }
      ],
      "description": "OUTWARD TT PO 5521",
      "customerReference": "PO-5521",
      "remittanceInformation": null,
      "additionalInformation": "OUTWARD TT PO 5521",
      "amount": 354000,
      "currency": "SGD",
      "direction": "DEBIT",
      "counterparty": {
        "name": "SHENZHEN BRIGHT ELECTRONICS CO LTD",
        "bank": "CMBCCNBSXXX",
        "bankAccountNumber": "755912345610801"
      },
      "bankAccount": {
        "id": "intacc_0RWF7FPY9Y4WK",
        "bank": "DBSSSGSGXXX",
        "bankAccountNumber": "0721845093"
      },
      "virtualAccountNumber": null,
      "transactionDate": "2026-10-08",
      "bookingDate": {
        "date": "2026-10-08",
        "time": null,
        "offset": null,
        "tz": null
      },
      "statementId": null,
      "createdAt": "2026-10-08T06:05:12.844Z",
      "updatedAt": "2026-10-08T06:05:12.844Z"
    }
  ]
}
```

## Statements [#statements]

An end-of-day statement has been processed. The transactions it reports are now available at
[/v1/transactions](https://docs.tryacme.com/reference/get-transactions). The event is `statements.created`.

`openingBalance` and `closingBalance` are `null` when the statement does not carry that balance for
the statement date and currency.

```json
{
  "id": "wbh_0RWF7FTRDY6B4",
  "createdAt": "2026-10-08T01:30:24.145087173Z",
  "mode": "LIVE",
  "event": "statements.created",
  "object": {
    "id": "stmt_0RWF7FTQDY7M7",
    "statementDate": "2026-10-07",
    "type": "CAMT.053",
    "bankAccount": {
      "id": "intacc_0RWF7FPY9Y4WK",
      "bank": "DBSSSGSGXXX",
      "bankAccountNumber": "0721845093"
    },
    "currency": "SGD",
    "createdAt": "2026-10-08T01:30:24.135Z",
    "updatedAt": "2026-10-08T01:30:24.135Z",
    "openingBalance": 18452300,
    "closingBalance": 19630850
  }
}
```
