---
url: https://bajoski34.github.io/Laravel/reference/events.md
---
# Events

All events live in `Flutterwave\Payments\Events` and fire from verified [webhooks](/guide/webhooks), once per webhook even when Flutterwave retries.

## WebhookReceived

Fires for every verified webhook, before the specific event below.

| Property | Type | |
| --- | --- | --- |
| `$event` | `string` | e.g. `charge.completed` |
| `$data` | `array` | The payload's `data` |
| `$payload` | `array` | The full payload |

## ChargeCompleted

`charge.completed`: a payment finished, successfully or not. Covers checkout, saved cards, virtual accounts and subscription renewals.

| Member | |
| --- | --- |
| `$transaction` | The transaction as re-fetched from the API (when `verify_charges` is on). Trust this one. |
| `$data` | The webhook body as sent |
| `$verified` | `true` when `$transaction` came from the API |
| `isSuccessful()` | Status is `successful` |
| `reference()` | The `tx_ref` |
| `amount()`, `currency()`, `customerEmail()` | From `$transaction` |

## TransferCompleted

`transfer.completed`: a payout succeeded or failed.

| Member | |
| --- | --- |
| `$data` | The transfer |
| `isSuccessful()` | Status is `SUCCESSFUL` |
| `reference()` | Your transfer reference |

## SubscriptionCancelled

`subscription.cancelled`. `$data` holds the subscription.

## QuoteCompleted

`quote.completed`, whenever an FX quote changes status. Despite the name, the quote may be `PROCESSING`, `READY`, `EXPIRED` or `FAILED`.

| Member | |
| --- | --- |
| `$data` | The quote |
| `isReady()` | You can trade it now |
| `quoteId()` | |

## ChargebackUpdated

`chargeback.initiated`, `.accepted`, `.declined` and `.lost`. Ask Flutterwave to enable chargeback webhooks for your account.

| Member | |
| --- | --- |
| `$event` | The webhook event name |
| `$data` | The chargeback |
| `status()` | Current status |
| `needsResponse()` | You still need to accept or decline it |

## Notifications

Two mail notifications ship with the package and are sent automatically when you set the addresses:

| Notification | Sent when | Config |
| --- | --- | --- |
| `ChargebackRaised` | A chargeback needs a response | `FLW_NOTIFY_CHARGEBACKS` |
| `TransferFailed` | A payout failed | `FLW_NOTIFY_FAILED_TRANSFERS` |

Both live in `Flutterwave\Payments\Notifications`, so you can also send them to your own notifiables.