Long-living payment requests
Available for Vipps.
Available for MobilePay in selected markets at the Vipps MobilePay joint platform launch.
💥 From Q4 2023, we will additionally send a push notification to the user when the payment is getting close to expiring. 💥
Vipps MobilePay offers Long-living payment requests for creating invoices and payments that can be postponed up to 28 days.
Please note: The user experience, including the standard timeout, should be as consistent as possible, so this should only be used in special cases. To request this feature, please contact your key account manager, your partner manager, or customer service.
Webhooks for ePayment events
Register a webhook to alert you when your payment requests are approved.
What are webhooks?
When changes happen to your payment request, events are triggered (for example: Authorized, Terminated, Aborted, Cancelled, Expired, and many more).
You can register to receive these events, which is useful for programming an appropriate and quick response.
The webhook will send a message to your web server at the URL you specify.
Here is an example HTTP POST:
secret to authenticate the message with HMAC. For examples, see
Webhooks API: Request authentication.
The payload from the ePayment webhooks will be in this form:
Note that the payload of the webhook depends on the originating service, in this case the ePayment API.
Customer's phone number
If you have the customer's phone number and their consent to send payment requests through Vipps MobilePay, you can send payment requests directly to them.
If you don't know your customer's phone number, you can start by sending them a link to your own landing page. There, you can trigger a payment request through Vipps MobilePay, which will request their phone number automatically.
Step 1. Create a payment request
create payment request,
customer.phoneNumber is set.
The customer will receive a push notification in their Vipps or MobilePay app.
Your system can send the payment request by using the
WALLET payment method. This functionality is only available when using
since the app is required.
expiresAt with a value between 10 minutes and 28 days (40320 minutes) in the future.
PUSH_MESSAGE to send a push directly to the customer.
Attach the receipt simultaneously.
You can also add the receipt at this time.
Here is an example HTTP POST:
"name": "Accident insurance",
"name": "Travel insurance",
See ePayment API: Long-living payments for more details.
Step 2. Customer approves the payment
The payment request will appear in the customer's Vipps or MobilePay app, where they can select to pay or cancel.
To get confirmation that payment was approved, monitor your webhooks.
Once the payment is approved, update the status in your system.
Since you have already attached order information to this payment, the customer will be able to see this in their Vipps or MobilePay app.
When they select
Show details in the payment confirmation screen, they are presented with the order information without leaving the app.
Note that, for long-living payments, customers also have the option of soft-dismissing the payment and postponing it for later.
Step 3. Capture the payment
Capture the payment and confirm that it was successful.
Sequence diagram for the standard online payment flow, where payment request is sent directly to app.