> **Description:** Learn how to implement and handle webhooks to receive real-time payment notifications and updates from Vipps MobilePay services.

# Webhooks

Webhooks are the recommended way to receive real-time notifications from Vipps MobilePay. When something happens -- a payment is authorized, a refund is issued, a recurring agreement is cancelled -- your server is notified immediately, without needing to ask.

## Why this matters

Without webhooks, your system has to repeatedly ask ("poll") the Vipps MobilePay API whether a payment status has changed. This is slower, less reliable, and consumes unnecessary API capacity.

With webhooks, Vipps MobilePay pushes the update to you the moment it happens. This means:

- **Faster order fulfillment.** Your system can act on a confirmed payment instantly -- triggering fulfillment, sending a receipt, or updating inventory -- without waiting for the next polling cycle.
- **Better customer experience.** No delays between a customer completing a payment and their order being confirmed.
- **Simpler, more reliable integrations.** Event-driven logic is easier to reason about and less prone to missed state changes than polling loops.

## What events you can subscribe to

Once registered, your server receives a notification whenever a matching event occurs for your sales unit:

- **ePayment:** payment created, authorized, captured, cancelled, refunded, aborted, or terminated
- **Recurring agreements:** accepted, rejected, stopped, or expired
- **Recurring charges:** reserved, captured, cancelled, or failed

See the full list of [event types](https://developer.vippsmobilepay.com/docs/APIs/webhooks-api/events.md).

## Getting started

Webhooks are provided by the [Webhooks API](https://developer.vippsmobilepay.com/docs/APIs/webhooks-api/README.md).

1. [Register a webhook](https://developer.vippsmobilepay.com/docs/APIs/webhooks-api/api-guide.md#register-a-webhook) for the events you want to receive.
2. Implement an endpoint on your server to [receive and process notifications](https://developer.vippsmobilepay.com/docs/APIs/webhooks-api/api-guide.md#receive-the-webhook-notification).

See the [Webhooks API guide](https://developer.vippsmobilepay.com/docs/APIs/webhooks-api/README.md) for full technical documentation.

> **Full site overview:** For every page in this documentation, read [https://developer.vippsmobilepay.com/llms.txt](https://developer.vippsmobilepay.com/llms.txt).