MobilePay Subscriptions


The integration of MobilePay Subscriptions to QuickPay is currently launched in a beta version. Read more about how to get started in the section about Beta

Beta


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.

due_date 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.

    due_date 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

Beta

The QuickPay integration with MobilePay Subscriptions was initially launched in a beta version.

The reason for that is that MobilePay Subscriptions, as the name suggests, is a subscription solution. To avoid that shops are signing customers up before the integration has been thoroughly tested, we initially recommend that your shop tests the system in their own flow.

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.

Contact QuickPay Support
Need help?

support@quickpay.net