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.
  • The quicker the merchant is to deliver the legimitation documents, the better. 
Merchant Business Contact

 Phase 1

Introduction 

Introduction
  • 1.1 Review technical MobilePay documentation and other integration materials.
    • Read GitHub documentation here
    • Read Getting Started here
    • Read FAQ here 
  • 1.2 Develop API integration plan with timeline.
    • When is your expected GO-LIVE date? (the merchant developer should align with their business unit)
Merchant Developer

 Phase 2 

Test Sandbox

Get started with Sandbox 

  • 2.1 Get developer account on https://sandbox-developer.mobilepay.dk/ by informing developer@mobilepay.dk which developers will be working on the integration 
  • 2.2 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)
  • 2.3 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)
  • 2.4 Conduct Sandbox verification (read more here

Merchant Developer 

 Phase 3 

Production Test

3. Get started with Testing in Production 

  • 3.1 Configure a Developer Account on https://developer.mobilepay.dk/
    • Create an app here
    • Subscribe to API's here
  • 3.2 Set up OpenID Connect to production values.
  • 3.3 Test the final actions in the API in Production
    • Create agreement (Read more here)
    • Request Subscriptions Payment (Read more here)
  • 3.4 Test integration on production
    • We recommend that you test internally within your organisation. Ensure that you have downloaded the newest version of the MobilePay app from the AppStore.

Merchant Developer 

Phase 4

Quality Assessment 

4.0 Assess technical integration 

  • 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. 
  • Once the technical verification is finished, we will add you to our operational mailbox.
Developer@mobilepay.dk

Phase 5

Marketing

5.0 Marketing checklist 

  • 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 informed your employees about MobilePay Subscriptions.
  • Ensure you have FAQ about MobilePay Subscriptions on your website. 
  • Ensure you adhere to our Brand Guideline.
  • Ensure you use the right MobilePay logo.
  • Ensure you use the correct Subscriptions assets.

Document final signup flow (forward screenshots of your customer registration/payment flow to developer@mobilepay.dk or present the flow in a Skype call) 

Tip: Read our inspirational page for Subscriptions here

Merchant Marketing 

&

Merchant Developer 

 Phase 6 

LIVE

6.0 Go live with MobilePay Subscriptions!

  • Your logo will be visible in the MobilePay app with a link to your landing page once the phases 0-6 are finished. 
Merchant Marketing

Remember to write to developer@mobilepay.dk if you have any further technical questions

Get Started  

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