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.created | An Incoming Payment Detail has been created in your Internal Account |
incoming_payment_detail.completed | The Incoming Payment Detail has posted to your Internal Account |
incoming_payment_detail.reconciled | A 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
Updated 4 months ago