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.  

Questionnaire 

Onboarding

Please prepare the following information so that we can best assist you in your onboarding:

  • Are you currently using an own in-hourse built payments management system or an external one?
  • What payment methods will you be using?
  • How is development handled?
    • Internal/external team?
    • Project scheduling?
    • Finance and reconciliation overview?

Onboarding tech call 

We recommend to have a kickstart tech call to plan the project, align the expectations and go through the Subscriptions and Invoice API. In this meeting, we would like your frontend and backend developers to join. Prior the meeting, they should have familiarized themselves with our Subscriptions and Invoice API. For all questions that you might have, please collect them and compile them, so it is easier to go through them together, and/or send us an e-mail to developer@mobilepay.dk  

 
API Integration Best Practice

 
Following our best practice will assist converting users to MobilePay. MobilePay has seen Subscription businesses get up and running in as little as a few days. The longer timeline estimates above are for existing Subscription businesses that have more complexity, given their known use cases. With this in mind, we estimate a total integration to take around 4–6 weeks, depending on how consistently your engineering team is working on the integration.

 
Onboarding process

  1. Scoping: Learn about key onboarding components and start to make integration decisions. (1 week)
  2. Integration: Start implementing based on the decisions you made in the scoping phase. Engineering and UX teams complete a lot of the work in this phase, but product managers and other nondeveloper teams are involved in making integration decisions. (3-4 weeks)
  3. TestingAs work is completed in the integration phase, you can start the testing phase. The workload in this phase is often split among several teams. Engineering teams can test charge flows, product managers can test verification flows, finance teams can verify reports and dashboard information, and so on. (1 week)
  4. Training: The training phase is mostly for nondevelopers. Customer service, finance, business, and product management teams are usually involved. Much of the training focuses on using the MobilePay Portal, understanding funds flows and using the Transaction Reporting API, and managing refunds and disputes. (1 week)
  5. Go-to-market: Work on strategies for user adoption and transitioning users to MobilePay from other payment methods. Even though this phase is last, there’s a lot you can work on in the beginning of the onboarding process. Having a strong GTM strategy gives you and your customers a smoother transition to MobilePay.
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

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 Portal

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