🚧
Please Note:

This webhook is in Beta testing and the parameters are subject to change.

While in Beta testing, this webhook will only be propagated via our staging environment.

The Multi-Currency Account Deposit Webhook is an asynchronous notification sent to your configured listener URL whenever a receiving account is credited via the SWIFT network. This notification allows your system to reconcile balances and update ledger entries in real-time without continuous polling.

Webhook Event Details

Event Type: CURRENCY_ACCOUNT_DEPOSIT
Payment Channel: SWIFT
Method: POST

Payload Contract

Field Path	Type	Description
`decentro_txn_id`	String	Unique Decentro transaction identifier for the credit event.
`event`	String	The type of event (e.g., `account_deposit_success`).
status	String	The terminal status of the deposit (e.g., SUCCESS).
`data.consumer_urn`	String	Unique identifier for the consumer associated with the account.
`data.currency_account_urn`	String	The unique URN of the account where funds were deposited.
`data.amount`	Number	The net amount credited to the account in the major currency unit.
`data.currency`	String	ISO currency code (e.g., USD).
`data.payment_channel`	String	SWIFT
`data.remitter_details`	Object	Metadata regarding the originating sender of the wire.
`data.remitter_details.name`	String	Name of the person or entity who sent the funds.
`data.remitter_details.account`	String	(Masked) account number of the sender.
`data.remitter_details.country`	String	Country Code of the Sender.
`data.remitter_details.bank_reference_number`	String	The unique transaction reference (UTR/RRN) from the banking network.

Webhook Example

{
  "decentro_txn_id": "9F8E7D6C5B4A3928170B1A2C3D4E5F6G",
  "event": "account_deposit_success",
  "status": "SUCCESS",
  "data": {
    "consumer_urn": "con_23723878391",
    "currency_account_urn": "CUR_ACC_99221",
    "amount": 10500.00,
    "currency": "USD",
		"payment_channel": "SWIFT",
    "remitter_details": {
      "name": "Acme Global Corp",
      "account": "XXXXXXXX4412",
			"country": "US",
      "bank_name": "JP Morgan Chase"
    },
    "bank_reference_number": "SWIFT2026021988172",
    "deposited_at": "2026-02-19T13:45:00Z"
  },
  "response_key": "success_account_deposit_notified"
}

200

400Bad Request