worldline
Sign up

MobilePay

MobilePay

Intro

In pilot

MobilePay is a Danish-Finnish mobile payment app.

With over 6 million users across both countries, native app integration, and server-to-server support, you can let customers pay easily and accept payments efficiently for your business.

You send a standard request to our platform to open the MobilePay app on your customers' mobile device.

The integration is very easy, as you only need to send one additional parameter along with your request.

Overview

Payment group:
Payment product id:
340
Key benefits
  • Low PCI requirements (no sensitive or personal data shared)
  • Easy integration
  • Very popular in Denmark/Finland
  • Allows
    Authorisations/Direct Sales
    Partial/multiple/full captures
    Partial/multiple/full refunds

Countries & currencies

Supported countries

Supported currencies

  • Euro (EUR)

Integration

Redirect your customers to the MobilePay app via integration methods Hosted Checkout Page or Server-to-server. Find a high level overview in the "Process flows" chapter.

Add the following properties to a standard CreateHostedCheckout/CreatePayment request:

{
    "cardPaymentMethodSpecificInput": {
        "paymentProductId": 340,
        "authorizationMode": "SALE",
        "redirectionData": {
            "returnUrl": "https://yourReturnUrl.com"
        }
    },
    "order": {
        "amountOfMoney": {
            "amount": 100,
            "currencyCode": "DKK"
        }
    }
}
Properties Description

order.amountOfMoney
     amount
     currencyCode

amount: The gross amount you want to charge for this order.
CurrencyCode: The ISO 4217 currency code for this amount. Fixed value "DKK".

cardPaymentMethodSpecificInput
     paymentProductId
     authorizationMode
     redirectionData.returnUrl

paymentProductId: The numeric identifier of the payment method on our platform. Find this id in the "Overview" chapter.

For payments requested via CreateHostedCheckout, it instructs our platform to send your customers directly to the MobilePay-branded version of our Hosted Checkout Page. If omitted, our platform sends your customers to the Hosted Checkout Page instead, allowing them to choose this or any other payment method that is active in your account.

authorizationMode: Set to either "FINAL_AUTHORIZATION"/"PRE_AUTHORIZATION"/"SALE" depending on whether you want to process payments in authorisation/Direct Sale mode.

returnUrl: The URL we redirect your customers to after the payment has been finalised.

Process flows

Depending on your customers' device(s) used, differences apply:

With a desktop and a mobile device

This flow involves both your customers' mobile/tablet and desktop device interacting with each other.

  1. Your customers finalise an order on their desktop device in your shop and select MobilePay.
  2. You send this CreateHostedCheckout/CreatePayment request to our platform.
  3. You redirect your customers on the desktop device via the redirectUrl (For CreateHostedCheckout requests) or merchantAction.redirectData.redirectUrl (For CreatePayment requests) to the MobilePay portal.
  4. Your customers enter their mobile phone number on the MobilePay portal.
  5. The mobile/tablet device opens the MobilePay app. Your customers confirm the payment in the app.
  6. We receive the transaction result.
  7. The mobile/tablet device displays the transaction result in the MobilePay app.
  8. We redirect your customers to your returnURL on their desktop device.
  9. You request the transaction result from our platform via GetPaymentDetails/GetHostedCheckout or receive the result via webhooks.
  10. If the transaction was successful, you can deliver the goods / service.

With a mobile device

  1. Your customers finalise an order on their mobile device in your shop and select MobilPay.
  2. You send this CreateHostedCheckout/CreatePayment request to our platform.
  3. You redirect your customers via the redirectUrl (For CreateHostedCheckout requests) or merchantAction.redirectData.redirectUrl (For CreatePayment requests).
  4. The mobile device opens the MobilePay app. Your customers confirm the payment in the app.
  5. We receive the transaction result.
  6. The mobile/tablet device displays the transaction result in the MobilePay app.
  7. You request the transaction result from our platform via GetPaymentDetails/GetHostedCheckout or receive the result via webhooks.
  8. If the transaction was successful, you can deliver the goods / service.

Testing

Refer to our Test cases for test data and detailed instructions.

Was this page helpful?

Do you have any comments?

Thank you for your response.
New Feature

Try out our new chatbot and find answers to all your questions.