API Integration plan 

This guide is designed to help get you started with integrating to the MobilePay API's. You'll be starting off in the Sandbox. Its purpose is to give developers a shielded environment for testing and integration purposes.  

API Checklist  
 

The goals of the integration plan are to: Confirm the functionality of the integration and create a plan for fine-tuning where required.

Phase Tasks of a MobilePay Subscriptions integration Responsible 

 Phase 0 

Onboarding 

Product Onboarding 
  • The merchant signs up for MobilePay Subscriptions in a few simple steps on the MobilePay Self-service portal https://admin.mobilepay.dk/  Once the merchant has completed the order (KYC / Legimitation etc), our onboarding team at erhverv@mobilepay.dk will verify your information and activate the Subscriptions and/or Invoice product.
 Merchant Business Contact

 Phase 1

Introduction 

Introduction
  • Review technical MobilePay documentation and other integration materials.
    • Read GitHub documentation here
    • Read Getting Started here
    • Read FAQ here 
  • Develop API integration plan with timeline.
    • When is your expected GO-LIVE date?
Merchant Developer

 Phase 2 

Test Sandbox

Get started with Sandbox 

  • Get developer account on https://sandbox-developer.mobilepay.dk/ by informing developer@mobilepay.dk which developers will be working on the integration 
  • Set up OpenID Connect
    • Obtain OpenID credentials via zip file
    • Set a redirect URI
    • Receive testdata
    • start implementing the OpenID Connect flow. (Read more here)
  • Test the API in Sandbox 
    • Make first call to Sandbox API
    • Test subscriptions (read more here)
      • Set payment callback url (read more here)
      • Set callback authentication scheme (read more here)
  • Conduct Sandbox verification (read more here

Merchant Developer 

 Phase 3 

Production Test

Get started with Production 

  • Configure developer account on https://developer.mobilepay.dk/
    • Create an app here
    • Subscribe to API's here
  • Set up OpenID Connect to production values
  • Test the final actions in the API in Production
    • Create agreement (Read more here)
    • Request Subscriptions Payment (Read more here)
      • note: it takes 8 days for a payment to execute in production
  • Test integration on production 
    • we recommend that you test internally within your organisation. Ensure that you have downloaded the MobilePay app on the AppStore.

Merchant developer 

 Phase 4 

Pre-Launch

Prepare for launch.

  • Document final signup flow (forward screenshots of your customer registration/payment flow to developer@mobilepay.dk
    • Ensure you have visible MobilePay buttons (you can do it on your website, newsletters and self-service environment)
    • Ensure you have a landing page dedicated for registrating for MobilePay
    • Ensure you inform your employees about MobilePay Subscriptions
    • Ensure you have FAQ about mobilePay Subscriptions on your website 
 

Phase 5

Quality Assessment 

Assess integration review

  • The developer Support team at developer@mobilepay.dk will review your integration prior going live and answer you within 24 Hours.
  • Please include all steps in phase 4 to ensure a quick assessment. 
 Developer@mobilepay.dk

 Phase 6 

LIVE

Go live with MobilePay Subscriptions!

  • your logo will be visible in the app 
 
Detailed - API Checklist  

You need to have ordered the product here in order to be invited. You will not be able to create an app and access the REST API to make test calls to them, unless you have been invited.

  1. Firstly, you will be contacted by MobilePay Business who will handle the product onboarding.
  2. Secondly, the DeveloperSupport team will handle your technical onboarding. 
  3. After having received the confirmation email and completed configuring your account, you will be able to login and start using our MobilePay test environment.

Once the above is handled, then you will receive an invite to MobilePay Sandbox Developer Portal, where you must create an user. The Developer Portal is primarily used by the technical contact. If there are more developers, who should be invited to the Developer Portal, please let us know and forward us their e-mail address, and then we will invite them.

The first steps

1. Log-in: 

In sandbox the URL is https://sandbox-developer.mobilepay.dk and for production the URL is https://developer.mobilepay.dk

Credentials are created using the mail invites received from the MobilePay Developer Support.

2. Create an app:

From the developer portal, click on your e-mail in the top and choose ”My Apps” at the top of the page. Click the create new app button.  

NOTE: You can create more than 1 app, but it is up to you and your implementation. How you handle the data internally in your organisation is up to you, and not MobilePay. If you decide to create more apps, then you also need to manage the data. We recommend that you keep it simple and stick to one app.

Once you have provided an application name, description, etc. the system automatically generates a set of client-secret and clientSecret for your app. You will be shown your application client_id and client_secret

Make a note of your client_secret because it is only displayed once. You must supply the credentials when you call an API that requires you to identify your app by using a Client ID and Client secret.  

For example, If you have two apps, then you need to manage the Client-secret and ClientSecret for 2 different apps. 

 

3. Go through OpenID Connect 

3. Subscribe to API's

Now that you’ve registered your app, you need to subscribe to Invoice and/or Subscriptions API's, depending on your need. 

  • Invoice
  • Invoice user simulation
  • Subscriptions
  • Subscriptions User Simulation
API Integration Best Practice

 
Following our best practice will assist converting users to MobilePay

 

Merchant flow 

  • The merchant signs up for MobilePay Subscriptions or Invoice in a few simple steps on the MobilePay Self-service portal https://admin.mobilepay.dk/ 
  • Once the merchant has completed the order (KYC / Legimitation etc), our onboarding team at erhverv@mobilepay.dk will verify your information and activate the Subscriptions and/or Invoice product.
  • If the merchant is already a MobilePay customer, they just need to select the product.   

MobilePay Subscriptions

MobilePay Portal

 

MobilePay Invoice