Skip to main content

Limitations

All new integrations: Use the ePayment API.

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

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 Checkout​

It's possible for international users to use Express Checkout, 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 the user will cancel the transaction in this scenario.

Note that the Express Checkout 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