Skip to main content

Frequently asked questions

Prepare for launch

The new platform is already launched in Finland and we are excitied to launch it in Denmark on March 12th. We have gained great experience through the Finnish launch and want to highlight three main topics we suggest you to be aware of:

  • Ensure that you have whitelisted our new servers to ensure that requests and callbacks are successful.
  • Once the new platform is launched all users must upgrade their app. This is a force upgrade of the app and must be completed in order to access MobilePay. This means that a lot of users will update the app on the 12th and the following days causing their user journy to be prolounged. This may result in expired payments while the user updates the app.
  • Operational issues will not be sent to the old operational mail lists but instead supplied through our new operational status pages. Ensure to sign up for the updates through the new pages.

What are the MobilePay IP addresses?

Note that MobilePay does not require merchants to whitelist specific IP addresses to access REST APIs. We utilize different ranges for the APIs and callbacks as well as for the different environments. We cannot supply specific IPs because we may change IPs within the listed ranges and therefore recommend to whitelist the entire range.

API requests
Production: 20.238.5.64/28 and 4.245.40.224/28
Sandbox: 4.175.250.192/28

Callbacks
Production and sandbox: 212.93.32.0/19 and 185.218.228.0/22

Important info

We are in the process of consolidating our platform with Vipps to create a new shared platform. For the products that are using facades (Subscriptions, App Payments and Online ) please note that we will use new servers for all callbacks. Therefore you must adhere to our new server guidelines.

Port: 443

What is the difference between Sandbox and Production

Sandboxes are isolated from your production organisation, so operations that you perform in the MobilePay sandbox don’t affect your production organisation. The production version of the API provides access to the real customer data, i.e. you will be able to initiate real payments. Once you go to test in production, you will use another basepath, the live MobilePay app and a real MobilePay user.

SandboxProduction
UserWe have test users available. Visit the product sites to find information about test usersA real MobilePay user, that has downloaded the MobilePay app on their smartphone. We do not have test user that you can use in production.
Payment limitSame as in production. Read here: DK - FI
FunctionalitySandbox processes API calls in exactly the same manner as the production environment, except you are not dealing with real money and transactions.Only real transaction can be completed
Endpointhttps://api.sandbox.mobilepay.dkhttps://api.mobilepay.dk
Mobilepay Portalhttps://sandprod-admin.mobilepay.dkhttps://admin.mobilepay.dk
How do I, as an Integrator test in production?

Once you have finished testing in sandbox and the verification, you can verify that the set-up is also working in production. This is especially important with regards to using the right redirect URI's in production, and using the right credentials for OpenID Connect in production. You need to update all URLs and credentials to production values.

Once you've done so, there are two possibilities, and you can choose the option, that fits you the best.

Test with your own customer

You can use one of your existing customers as pilot merchant. In order to do so they need to have an active MobilePay agreement and chosen the decired MobilePay product.

Test with your own account

If you do not want to test with your customer, you have the possibility to order the API product yourself, so you have a registration in production. In this case, you'll be marked as an integrator, and will only pay for the transactions, and not the monthly fee.

Payment limit in Sandbox

The behavior of the API when you are in sandbox mode is the same as when your app is live, but comes with the following restrictions. The users in the Sandbox have a daily limit at 3.000 DK. It is recommended to send Payment Requests below 10 DKK or 2 EUR. Be sure to test with reasonable amounts and only run a limited number of transactions.

What is correlationId?

CorrelationId is a unique identifier value that is set as header for each API request

header 'correlationid: REPLACE_THIS_VALUE'

The id serves as reference for the particular API request and makes API support more efficient. If you are having issue with an API request, please include the correlationId. We recommend to use a random GUID as the correlationId.

What is payment reference

If you have one of our MobilePay products, then you can expect to see a Payment Reference in your bank account. Payment reference is a reference that is assigned to payment and is visible in bank account statement when payment is completed and received by your bank. It is usually used for tracking and verifying which payments were received to the bank account (e.g. transfers).

MobilePay specific reference: PCRRRRRRRRJJJDDMMYYX

PC Product code - Products need to identify the product, code is then put when generating the reference.

  • 01 = POS
  • 02 = MyShop
  • 03 = Subscriptions
  • 04 = Invoice
  • 05 = AppSwitch
  • 06 = Online

RRRRRRRR External Payment Point ID (length 8). Myshop number, Pos LocationID etc. External Payment PointID will be sent in the payload from the product.The external payment point ID must be unique within the Merchant for the payment point. For Subscription and Invoice this will consist of 8 zeros (00000000).

JJJ Running number (length 3)

DDMMYY Date (lenght 6)

X Check digit (length 1)

Example: 03000000000011602193 - which indicates Subscriptions payments received 16.02.2019