# Banking Events

Webhook event payloads emitted by the Banking API. Events are delivered through the [Aritma Events API](/apis/platform/events/) using the [CloudEvents](https://cloudevents.io) specification.

Event payloads closely mirror the responses from the corresponding Banking API endpoints, so the data structures will already be familiar if you use the REST API.

Version: 1.0.0

## Download OpenAPI description

[Banking Events](https://developer.aritma.com/_bundle/apis/banking/v4/openapi/banking-events-openapi.yaml)

## Account Events

### Account created

 - [POST banking.account.created](https://developer.aritma.com/apis/banking/v4/openapi/banking-events-openapi/account-events/banking.account.created.md): Fired when a new banking account has been created. Includes account identifiers (IBAN/BBAN), BIC, currency, and display name.

Related endpoint: Get account

### Approval settings changed

 - [POST banking.account.approval_settings.updated](https://developer.aritma.com/apis/banking/v4/openapi/banking-events-openapi/account-events/banking.account.approval_settings.updated.md): Fired when the approval settings for an account have been changed, such as toggling pre-approval or updating the number of required approvers.

Related endpoint: Get account parameters

### Account status changed

 - [POST banking.account.status.updated](https://developer.aritma.com/apis/banking/v4/openapi/banking-events-openapi/account-events/banking.account.status.updated.md): Fired when the status of an account has been updated. The accountStatus field indicates the new status.

Related endpoint: Get account

### Balance updated

 - [POST banking.account.balance.updated](https://developer.aritma.com/apis/banking/v4/openapi/banking-events-openapi/account-events/banking.account.balance.updated.md): Fired when the balance of a banking account has been added or updated. Contains the current balances and account identifiers.

Related endpoint: Get account balances

### Transaction received

 - [POST banking.account.transaction.received](https://developer.aritma.com/apis/banking/v4/openapi/banking-events-openapi/account-events/banking.account.transaction.received.md): Fired when a new transaction has been received for an account. The payload contains the full transaction information including amounts, parties, and remittance data.

Related endpoint: Get transaction details

## Payment Events

### Payment status changed

 - [POST banking.payment.status.updated](https://developer.aritma.com/apis/banking/v4/openapi/banking-events-openapi/payment-events/banking.payment.status.updated.md): Fired when the status of a payment has been updated. Includes the current transaction status and any TPP messages providing additional details.

Related endpoint: Get payment status

### Payment authorized

 - [POST banking.payment.authorized](https://developer.aritma.com/apis/banking/v4/openapi/banking-events-openapi/payment-events/banking.payment.authorized.md): Fired when a payment has been successfully authorized by a user. Includes the count of required and remaining authorizations for multi-approval flows.

Related endpoint: Get payment information

### Bulk payment status changed

 - [POST banking.bulk_payment.status.updated](https://developer.aritma.com/apis/banking/v4/openapi/banking-events-openapi/payment-events/banking.bulk_payment.status.updated.md): Fired when the status of a bulk payment or one of its related payment lines has been updated.

Related endpoint: Get bulk-payment information

## Mandate Events

### Mandate status changed

 - [POST banking.mandate.status.updated](https://developer.aritma.com/apis/banking/v4/openapi/banking-events-openapi/mandate-events/banking.mandate.status.updated.md): Fired when the status of a mandate has been updated. Includes rejection reason codes and proprietary text if the mandate was rejected.

### Mandate created

 - [POST banking.mandate.created](https://developer.aritma.com/apis/banking/v4/openapi/banking-events-openapi/mandate-events/banking.mandate.created.md): Fired when a new direct debit mandate has been created. Contains the mandate status, reference, and the date of the last action.

### Mandate updated

 - [POST banking.mandate.updated](https://developer.aritma.com/apis/banking/v4/openapi/banking-events-openapi/mandate-events/banking.mandate.updated.md): Fired when an existing mandate has been updated. Contains the current mandate status, reference, and the date of the last action.

## Consent Events

### Consent status updated

 - [POST banking.consent.status.updated](https://developer.aritma.com/apis/banking/v4/openapi/banking-events-openapi/consent-events/banking.consent.status.updated.md): Fired when the status of a consent changes (e.g. authorized, expired, revoked).

Related endpoint: Get consent