Skip to main content

Invoice to ePayment

Read more about the transition to one platform on the MobilePay site. Below, you can find comparison between the existing MobilePay Invoice API and the new ePayment API replacing MobilePay Invoice.

Visit our Recommended flows section to see the recommended flow for invoice.

Please note that ePayment encompasses various use case scenarios. Therefore, if you are seeking use cases that target existing MobilePay merchants and can be utilized for migration purposes, some examples include:

info

If you didn't make the integration yourself, talk with your partner.

Authentication and management

We will have a joint authentication solution across our API platform and introduce a Management API to retrieve merchant data. Read more here.

Input formats

MobilePay invoiceVipps MobilePay ePayment
InvoiceIssuer​Merchant-Serial-Number (see HTTP headers) ​
ConsumerAlias {Alias, AliasType}Customer {Alias} (Example: 4512345678)
TotalAmount​amount {currency, value (øre)}​
InvoiceNumber / PaymentReference​referencepaymentDescription
DueDate​expiresAt (Must be between 10 minutes and 28 days. Example: 2023-02-26T17:32:28)​
(InvoiceLinkRedirectUrlreturnUrl (The URL the user is redirected to after the payment session).​
Comment​N/A
ConsumerAddressLines []N/A
DeliveryAddressLines []N/A
ConsumerName​N/A
TotalVATAmount​N/A
IssueDateN/A
OrderDateN/A
OrderDateN/A
DeliveryDate​N/A
MerchantContactNameN/A
MerchantOrderNumberN/A
BuyerOrderNumber​N/A
InvoiceUrlInvoiceArticles []See: Order Management API
N/A ​paymentDescription​
N/Aprofile (scope)​
N/A ​paymentMethod (WALLET or CARD. CARD → WEB_REDIRECT)​
N/AuserFlow (PUSH_MESSAGE, NATIVE_REDIRECT, WEB_REDIRECT, QR) ​
N/AqrFormat {format, size} (only applicable when userFlow is set to QR) ​
N/AcustomerInteraction (CUSTOMER_PRESENT, CUSTOMER_NOT_PRESENT)​
N/AindustryData (In special cases only: Additional compliance data related to the transaction)​

Test environment

The test environment is called Merchant Test (MT) and is now open for test. MT currently only allows Norwegian phone numbers, currency and merchants, but you can test the API and payment flow. Please see the details of limitations of the test environment.

note

Management API and Report API is not available in MT and can only be tested in production.

In order to request access to the test environment, please use the following links:

We will e-mail you with the information you need to get started. This is also needed even though you are an existing MobilePay integrator or merchant, since we need your information registered on our new joint platform.

Help us improve our documentation

Did you find what you were looking for?