Quickpay

Pricing Developers Log in Sign up

Product

Payment methods Integrations Partner program

Resources

Quickpay Index Blog Helpdesk

Payment method

MobilePay Subscriptions

Quickpay allows you to accept payments with MobilePay Subscriptions.

With MobilePay Subscriptions you can accept recurring payments using MobilePay. MobilePay is a payment product designed for use with mobile devices. MobilePay Subscriptions enables the customer to see subscriptions and payments through MobilePay.

Advantages The most popular mobile payments service in Denmark Customers are likely to update their payment card information in MobilePay when receiving new cards. Danish customers are very familiar with the MobilePay interface

Please note: That the MobilePay Subscriptions integration, is relatively a new product. We have therefore not been around all conceivable usecases and scenarios yet.

That means that there can be a few things that might not work as is supose to do, or in some cases f.ex. the status might not be set correctly for a payment.

But we have merchants that are fully using MobilePay Subscriptions with great succes.

Read more about it under Test thoroughly and follow the open issues in this guide below.


MobilePay Subscriptions is MobilePay’s service for receiving recurring payments.

After the agreement has been set up, MobilePay Subscriptions largely functions as subscriptions with cards through Quickpay.

The customer is directed to a payment link, and can then choose MobilePay as payment method. The customer will then be sent to MobilePay’s window, where they have to enter a telephone number as with a regular payment, and then complete the transaction in their MobilePay app.

However when making a recurring payment there is a small change compared to the normal flow, because the payment can’t be withdrawn immediately on MobilePay Subscriptions. When creating the recurring payment, you have to choose a date on which the money has to be withdrawn. It has to be a minimum of 24 hours in the future and up to 126 days. On the set date, the money will be withdrawn automatically.

Apply for an agreement

Apply for a MobilePay Subscription agreement at https://mobilepay.dk/hjaelp/mobilepay-til-erhverv/mobilepay-subscriptions/kom-i-gang/hvordan-faar-min-virksomhed-mobilepay-subcriptions#scroll

Set up MobilePay Subscriptions

The setup presupposes that you have an agreement with MobilePay Subscriptions.

  1. In Quickpay Manager go to Settings > Acquirers > MobilePay Subscription
  2. Click on “Connect MobilePay Subscriptions”
  3. Enter your VAT-number
  4. You will now be directed to the login page for MobilePay Subscriptions. After logging in, you need to approve the integration with Quickpay. Your user will need to have the “super-manager” role in MobilePay, for you to be able to approve the integration.
  5. You will now be directed back to the Quickpay Manager, where you will have to log in again.
  6. Click on “Select provider” - If you accept payments from more than one provider in MobilePay Subscriptions, you must choose which one to use with Quickpay.
  7. Click on “Enable MobilePay Subscriptions”

You are now ready to receive subscriptions with MobilePay.

Payment Flow in MobilePay Subscriptions

Creation of subscription

A subscription is created as usual.

No money will be reserved or transferred when creating a subscription. Only when a recurring payment is made.

In the payment window, the customer can choose to pay with MobilePay, or you can send the customer directly to MobilePay by specifying payment method

The customer is then sent to MobilePay’s window, where they need to enter their phone number.

If the payment window is opened on a device with the MobilePay app installed, the customer will be sent directly to the app

If a telephone number is included in the payment under invoice_address this will be prefilled in the first MobilePay window

The customer then completes and approves the transaction in the app and will be sent back to the payment window or directly to the store.


Merchant country and currency

It is only possible for Danish or Finnish merchants to get an agreement with MobilePay Subscriptions.

For Danish merchants only DKK is supported as currency.

For Finnish merchants only EUR is supported as currency.

Payment methods

If you use payment methods to determine which types of payment methods will be displayed in the payment window, you must remember to add mobilepay-subscriptions for example

payment_methods = visa, mobilepay-subscriptions

The customer can then select MobilePay as payment method in the payment window.

If you exclusively want to receive payments through MobilePay Subscriptions, you must use

payment_methods = mobilepay-subscriptions

Subsequent Recurring Payments

Withdrawals on subscriptions are done as usual with https://learn.quickpay.net/tech-talk/api/services/#POST-subscriptions–id-recurring—format-.

A withdrawal with MobilePay Subscriptions must be “notified” at least 24 hours in advance, i.e. if a withdrawal/recurring is made on August 25, the money transfer itself will not take place until August 27.

Recurring payments with MobilePay Subscriptions are processed automatically.

Two additional parameters must be included for MobilePay Subscriptions.

**NOTE: Before MobilePay Subscriptions goes out of beta, there may be changes to these required parameters.

description is a description of the product or service for which the recurring is made.

auto_capture_at is the date on which the withdrawal itself takes place.

The flow is as follows:

  1. On August 25 at 4.00 p.m., a recurring payment will be created in Quickpay for a subscription with MobilePay Subscription.

    auto_capture_at is set for August 27, which is the earliest possible date.

    The payment is created in Quickpay with state = new and an Approved authorize operation.

    This payment cannot be captured.

  2. On August 27 - MobilePay automatically attempts to withdraw the amount set in the request.

    MobilePay will try to withdraw the money around 2 a.m. and if that fails, MobilePay will attempt the withdrawal at 2-hour intervals for the rest of the day.

    If the withdrawal is successful, a message will be sent from MobilePay to Quickpay, and the payment will automatically change status to state = processed and a capture operation will be set as Approved

API Response on recurring request

POST /subscriptions/{id}/recurring does not have a reponse.

For a response you will have to look at the Location header, which will show URL to the payment which is created on the recurring.

Example: location: https://api.quickpay.net/payments/231437087/operations/1

Test thoroughly

MobilePay Subscriptions, as the name refers to, is a subscriptions system. And to avoid that the shop sign up a lot of costumers in the system, before the integration are testet thoroughly, we recommand that you, as the shop owner test the system, before adding it to the paymentflow.

Open issues

The known issue is: When the costumers press “cancel” in the browser before they complete in MobilePay.

In the window were the countdown is and the costumer complete the buy in the MobilePay app, they have the option to press “cancel”, so the costumer can interrupt the payment. The result of that is recently, that the costumers then gets returned to the payments window, but ends in a update loop, the costumers then only have the options to close the window and try the payments again.

Payment Window and Branding Version

When MobilePay Subscription goes out of beta, there will be a new “release” of Standard Branding, which you have to use to be able to receive payments through MobilePay Subscription.

Until then, you must use a specific branding version in order to receive payments.

  1. Go to https://github.com/Quickpay/standard-branding
  2. Click on the green “Code” button and click “Download ZIP”
  3. In Quickpay Manager go to Settings > Branding
  4. Create a new branding with “Empty” as template
  5. Click on your new branding and at the top select “Upload new file”
  6. Select the downloaded zip file.
  7. Make sure to use the new branding when testing MobilePay Subscriptions.