Vipps paymentsPrivate preview

A Checkout Session must satisfy all of the following conditions to support Vipps payments:

• Prices for all line items must be expressed in Norwegian Krona (currency code NOK).

First, you need a Stripe account. Register now.

Use our official libraries to access the Stripe API from your application:

# Available as a gem
sudo gem install stripe

# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Enable Vipps as a payment method

When creating a new Checkout Session, you need to:

1. Provide the vipps_preview=v1 preview header with your API version on requests
2. Add vipps to the list of payment_method_types
3. Make sure all your line_items use the nok currency

Stripe.api_version = '2025-03-31.basil; vipps_preview=v1'

Stripe::Checkout::Session.create({
  mode: 'payment',
  payment_method_types: ['card'],
  payment_method_types: ['card', 'vipps'],
  line_items: [{
    price_data: {
      currency: 'usd',
      # To accept `vipps`, all line items must have currency: nok
      currency: 'nok',
      product_data: {
        name: 'T-shirt',
      },
      unit_amount: 2000,
    },
    quantity: 1,
  }],
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
})

Fulfill your orders

After accepting a payment, learn how to fulfill orders.

Stripe sends a payment_intent.succeeded event when the payment completes. Use the Dashboard, a custom webhook, or a partner solution to receive these events and run actions, like sending an order confirmation email to your customer, logging the sale in a database, or starting a shipping workflow.

Listen for these events rather than waiting on a callback from the client. On the client, the customer could close the browser window or quit the app before the callback executes, and malicious clients could manipulate the response. Setting up your integration to listen for asynchronous events also helps you accept more payment methods in the future. Learn about the differences between all supported payment methods.

Manually

Use the Stripe Dashboard to view all your Stripe payments, send email receipts, handle payouts, or retry failed payments.

• View your test payments in the Dashboard

Custom code

Build a webhook handler to listen for events and build custom asynchronous payment flows. Test and debug your webhook integration locally with the Stripe CLI.

• Build a custom webhook

Prebuilt apps

Handle common business events, like automation or marketing and sales, by integrating a partner application.

To test your integration in a testing environment, it redirects you to a test payment page where you can approve or decline the test payment.

In live mode, enter the phone number linked to Vipps to send a push notification to your Vipps mobile application. You can approve or decline the payment in the Vipps mobile application.