Skip to main content

Limitations

View as Markdown (opens in a new tab)
Install AI tools

Give your assistant up-to-date guidance for our APIs, with our plugin or without it.

The plugin is still under development. See the AI tools page for details.

Run both commands, in order.

claude plugin marketplace add vippsas/agent-toolkit
claude plugin install vipps-developer@agent-toolkit

For troubleshooting, see the full instructions.

Info

All new integrations: Use the ePayment API.

Existing eCom API users: See the eCom to ePayment migration guide for step-by-step migration instructions.

This API is only available in the Norwegian market.

International payments​

For merchants still using the Vipps eCom API, normal payments should be possible from international users; however, there are some limitations with the other eCom features.

Payment creation​

POS payments will not work because the country code is missing from the mobile number in the eCom initiate payment endpoint. The request expects all phone numbers to be Norwegian.

It is possible to pay if the merchant uses the one-time payment QR or the Merchant redirect QR.

Payments that go through the landing page also work fine, because the landing page provides us with the country code. Payments that skip the landing page are not possible for international users.

Skipping the landing page​

When using SkipLandingPage in the eCom API, it's not possible to start payments with the country code. Therefore, if your integration uses SkipLandingPage (e.g., POS, vending machines), it's only possible to start a payment to a Norwegian phone number.

Express​

It's possible for international users to use Express, when they provide a Norwegian address.

If a non-Norwegian address is entered, the user is blocked from proceeding. In such a case, the user will encounter an error in the app when attempting to pay and will be prompted to enter a Norwegian address to continue.

It's likely that the payment process will either time out or be cancelled by the user in this scenario.

Note that the Express payment details, returned by the eCom API: Get Payment Details endpoint, do not contain the country code:

"userDetails": {
        "email": "user@example.com",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "mobileNumber": "12345678",
        "userId": "3WYqbLVX139VmM0hxo3fSA=="
}

Profile sharing​

Profile sharing works as expected. When you check user info with the sub, you will get the country code of the user.

Last updated on