Tracking Received Payments

Modern Treasury allows you to track the lifecycle of payments you receive into your Internal Accounts through an object called an Incoming Payment Detail. Incoming Payment Details are records of received payments and will reconcile to a transaction once the funds move into or out of your account.

📘

If you are using the "Bring Your Own Bank" model, note that not all banks support Incoming Payment Details.

Incoming Payment Detail Webhooks

Subscribe to Incoming Payment Detail webhooks on your Internal Accounts to determine when you have received a payment.

Event
incoming_payment_detail.createdAn Incoming Payment Detail has been created in your Internal Account
incoming_payment_detail.completedThe Incoming Payment Detail has posted to your Internal Account
incoming_payment_detail.reconciledA transaction has reconciled to the Incoming Payment Detail in your Internal Account

Here is an example of an incoming_payment_detail.created webhook for a $5.23 wire:

{
  "id": "2f2233db-60f1-43dd-b86c-53da6a653e8e",
  "type": "wire",
  "amount": 523,
  "object": "incoming_payment_detail",
  "status": "pending",
  "currency": "USD",
  "metadata": {},
  "direction": "credit",
  "live_mode": true,
  "vendor_id": "019beb30-de59-7026-b137-ce8eebabed7a",
  "as_of_date": "2026-01-23",
  "created_at": "2026-01-23T14:10:09Z",
  "updated_at": "2026-01-23T14:10:09Z",
  "transaction_id": null,
  "virtual_account": null,
  "virtual_account_id": null,
  "internal_account_id": "bf5f1df9-de01-40c2-9040-7ec10170a12b",
  "ledger_transaction_id": null,
  "reconciliation_status": "unreconciled",
  "transaction_line_item_id": null,
  "originating_routing_number": null,
  "originating_account_number_safe": null,
  "originating_account_number_type": null,
  "originating_routing_number_type": null
}

Viewing Incoming Payment Details in the Modern Treasury App

You can also view a received payment in the Modern Treasury WebApp.

  • In the Modern Treasury application, navigate to the Payment Orders tab
  • Find the Incoming Payments tab and filter by the specific account
  • To see the full payload, click on Incoming Payment Detail Data