> **Description:** Technical constraints and boundary conditions for eCommerce API usage.

# Limitations

**INFO**

 **All new integrations:** Use the [ePayment API](https://developer.vippsmobilepay.com/docs/APIs/epayment-api/README.md).

 **Existing eCom API users:** See the [eCom to ePayment migration guide](https://developer.vippsmobilepay.com/docs/APIs/epayment-api/migration.md) for step-by-step migration instructions.

## International payments

For merchants still using the [Vipps eCom API](https://developer.vippsmobilepay.com/docs/APIs/ecom-api/README.md), 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](https://developer.vippsmobilepay.com/redocusaurus/ecom-swagger-id.yaml).
The request expects all phone numbers to be Norwegian.

It is possible to pay if the merchant uses the [one-time payment QR](https://developer.vippsmobilepay.com/docs/APIs/qr-api/api-guide/one-time-payment.md)
or the [Merchant redirect QR](https://developer.vippsmobilepay.com/docs/APIs/qr-api/api-guide/merchant-redirect.md).

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](https://developer.vippsmobilepay.com/redocusaurus/ecom-swagger-id.yaml),
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](https://developer.vippsmobilepay.com/docs/APIs/epayment-api/api-guide/features/express.md), 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](https://developer.vippsmobilepay.com/redocusaurus/ecom-swagger-id.yaml) endpoint,
do not contain the country code:

```json
"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](https://developer.vippsmobilepay.com/docs/APIs/userinfo-api/userinfo-api-guide.md) with the `sub`, you will get the country code of the user.

> **Full site overview:** For every page in this documentation, read [https://developer.vippsmobilepay.com/llms.txt](https://developer.vippsmobilepay.com/llms.txt).