Vipps
Vipps is the most used mobile wallet in Norway, with almost 4.7 million users. Your customer pays with a card stored in the Vipps app and approves the payment in the app. Vipps processes in Norwegian kroner (NOK).
Rootline processes a Vipps payment as a card payment. You capture, cancel and refund it the same way as a card payment. Unless your account captures automatically, send a capture request to collect the funds.
Payment method details
| Currency | NOK |
| Countries | NO |
| Minimum transaction value | 1.00 NOK |
| Maximum transaction value | No limit set by Rootline. The customer's card limit applies. |
| Payment method session expiry | 10 minutes to approve the payment in the Vipps app. |
| Capture | Supported. Partial and multiple partial captures are supported. |
| Cancel | Supported. A cancel releases the full amount that is not captured yet. A partial cancel is not possible. |
| Refund | Full and (multiple) partial refunds are supported. |
| Disputes | Supported. Disputes follow the rules of the card scheme. |
| Tokenization | Not supported |
| Statement descriptor | Mastercard supports 18 characters and Visa 21. The statement descriptor starts with RTL*, which Rootline adds and which does not count towards the character limit, followed by your merchant name and the statement descriptor you can provide with the payment request. Characters exceeding the character limit will not be shown on the customer's statement. The statement descriptor is also shown as the payment description in the Vipps app. If it is empty, the description is used. |
| Supported integrations | Checkout Components (Payment Methods List), Hosted Checkout |
How your customer pays with Vipps
- Your customer selects Vipps in the Rootline checkout, or on your own page when you use the redirect integration.
- Rootline sends your customer to Vipps. Your customer approves the payment in the Vipps app with a card stored in the app.
- If the card issuer asks for 3D Secure, your customer completes it in the Rootline checkout.
- Rootline sends your customer back to your
return_url.
The return to your return_url does not confirm the payment. Rootline receives the result from Vipps separately, so use webhooks to get the final payment status.
Create a seamless flow with the Payments API
In The Payment API section we explain how to use the Payments API to create a payment flow.
Checkout integration
Let Rootline handle the payment method selection. Start the payment by sending a payment request with the details below. Vipps payments must be in Norwegian kroner (NOK).
The API returns a next_action object with a checkout_url. This URL leads your customer to the Rootline checkout page, where they select their payment method and enter their payment details.
Seamless redirect from your website to Vipps
You can send your customer from your own page straight to Vipps, without showing the Rootline checkout. Your customer selects the payment method on your page. To mark the payment as a Vipps payment, add payment_rails.payment_method with the value vipps to the request above:
Use the redirect URL in the response to send your customer to Vipps. After the payment, your customer returns to the return_url you provided.