Step 1 - Getting Started 

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

Step 1 - Register

  1. All merchants should order the product needed on the MobilePay portal here   (If you are a Third Party integrator, follow the process described here)
    1. Sign up as an integrator here 
    2. Sign certification agreement 
  2. Take a look at the API documentation. You'll find it in the APIs menu.
  3. You should already have received an email with an invitation to our Sandbox environment.
  4. Go to and log in with your credentials.
  5. Next you select your account > My Apps > Create new App to register a new application.
    1. IMPORTANT: Please make a note of your Client Secret as you will only see this once! You need to supply the x-ibm-client-id and x-ibm-client-secret when calling the api. 

You should always store the Client Secret in a secure location, and never reveal it publicly. If you suspect that the secret key has been compromised, you may reset it immediately by clicking the link on the application details page.

Step 2 - Subscribe to APIs

To implement MobilePay Subscriptions, go to APIs and subscribe to the following APIs:

  • Subscriptions
  • Subscriptions User Simulation

From the API-page you're able to call the api and get the appropiate responses

Step 3 - Authentication

 Once you have obtained credentials via zip file, set a redirect URI and received test data, you can start implementing the OpenID Connect flow. Read more about OpenID Connect and the process here.

Currently, our network utilizes the global IP range

  As an external party, you might need to modify your firewall rules to allow traffic from us from and instead. Otherwise our traffic may be blocked, and our services stop working.

Step 2. Test

Test early and test often. It's a great way to identify potential issues with your integration, and it gives you many opportunities to get familiar with the MobilePay APIs. We will provide you with test data, to test in the sandbox environment.