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
- QR: user check-in
See the full list of event types.
Getting started​
Webhooks are provided by the Webhooks API.
- Register a webhook for the events you want to receive.
- Implement an endpoint on your server to receive and process notifications.
See the Webhooks API guide for full technical documentation.