Account Notifications
Account webhook notifications inform you of events that happen and that apply to the accounts of your customers. Learn more how you can start receiving webhook notifications in the webhooks guide.
Weavr sendsSend A transaction type that allows sending funds to another identity's instrument or to a beneficiary. Send transactions may require Strong Customer Authentication depending on the destination and whether it's a trusted beneficiary. the following account-related webhook notifications:
Account IWTsIWT Incoming Wire Transfer - a transaction that occurs when funds from a bank account held at a third-party financial institution are moved to a Weavr managed account. IWTs are initiated externally by the owner of the source bank account, and the managed account must have an assigned IBAN to receive funds. (incoming wire transfersWire Transfer A transaction that moves funds between accounts. An incoming wire transfer moves funds from a third-party bank account to a Weavr managed account, while an outgoing wire transfer moves funds from a Weavr managed account to a third-party bank account. Wire transfers require the managed account to have an assigned IBAN (for EUR) or sort code and account number (for GBP).)
Weavr uses webhooks to inform you when an IWTIWT Incoming Wire Transfer - a transaction that occurs when funds from a bank account held at a third-party financial institution are moved to a Weavr managed account. IWTs are initiated externally by the owner of the source bank account, and the managed account must have an assigned IBAN to receive funds. is received on an account. The webhook includes the fields transactionId and transactionAmount that represent the transaction identifier and its amount. You can use these notifications to notify customers that funds are now available on their accounts.
The information is sent to you using the ${WEBHOOK_URL}/managed_accounts/deposits/watch webhook URL.
The ${WEBHOOK_URL} is the URL configured in your application settings.
Notifications can also be used in conjunction with the following endpoint which shows the effect of a deposit on the actualBalance and availableBalance of the account.
IWTsIWT Incoming Wire Transfer - a transaction that occurs when funds from a bank account held at a third-party financial institution are moved to a Weavr managed account. IWTs are initiated externally by the owner of the source bank account, and the managed account must have an assigned IBAN to receive funds. credited immediately
When an IWTIWT Incoming Wire Transfer - a transaction that occurs when funds from a bank account held at a third-party financial institution are moved to a Weavr managed account. IWTs are initiated externally by the owner of the source bank account, and the managed account must have an assigned IBAN to receive funds. is credited immediately, just one webhook is sent with the state COMPLETED.
If the API endpoint is called, then the transactionAmount (from the webhook) is reflected in both the actualBalance and availableBalance in the API.
IWTIWT Incoming Wire Transfer - a transaction that occurs when funds from a bank account held at a third-party financial institution are moved to a Weavr managed account. IWTs are initiated externally by the owner of the source bank account, and the managed account must have an assigned IBAN to receive funds. held for compliance checks
When an IWTIWT Incoming Wire Transfer - a transaction that occurs when funds from a bank account held at a third-party financial institution are moved to a Weavr managed account. IWTs are initiated externally by the owner of the source bank account, and the managed account must have an assigned IBAN to receive funds. is held for compliance checks (e.g. a Source of Funds declaration is required), two webhooks are sent.
The first webhook is sent when the deposit is received (and held) and has the state : PENDING. The IWTIWT Incoming Wire Transfer - a transaction that occurs when funds from a bank account held at a third-party financial institution are moved to a Weavr managed account. IWTs are initiated externally by the owner of the source bank account, and the managed account must have an assigned IBAN to receive funds. also shows up in Data Insights in your portal with the state UNDER_REVIEW. However, the IWTIWT Incoming Wire Transfer - a transaction that occurs when funds from a bank account held at a third-party financial institution are moved to a Weavr managed account. IWTs are initiated externally by the owner of the source bank account, and the managed account must have an assigned IBAN to receive funds. is not reflected in the balance of account at this point, and so the actualBalance and availableBalance do not show any changes if the API endpoint is called.
When compliance checks are completed, a second webhook is sent with the state : COMPLETED. If the API endpoint is called, then both the actualBalance and availableBalance reflect the deposit.
Example
Initial balance (amounts in cents/pence) = 77650, deposit for 1500000 (held for compliance checks).
Deposit received and held for compliance checks. The first webhook is sent with transactionAmount.amount : 1500000 and state : PENDING.
API balances:
"balances": {
"actualBalance": 77650,
"availableBalance": 77650
Compliance checks are completed, deposit fully processed and money can be used. The second webhook is sent with transactionAmount.amount : 1500000 and state : COMPLETED
API balances:
"balances": {
"actualBalance": 1577650,
"availableBalance": 1577650
Account Updates
Weavr uses webhooks to inform you when there is an update to an account. The webhook includes the account object containing all information related to the account that has been updated. The type field describes the action that was performed on the account.
The information is sent to you using the ${WEBHOOK_URL}/managed_accounts/watch webhook URL.