Skip to main content

How MobilePay Online works

End of life

This API doesn't have any set end of life yet, but is receiving critical maintenance only. Long term support for PSPs will be served by the ePayment API. No new integrations to this API will be approved.

How payments in web shops or merchant websites work with MobilePay Online.

Details​

1. Customer picks MobilePay at checkout​

Make MobilePay available as a payment option in your webshop or app—easy and familiar for your customers!

Web checkout showing MobilePay as a payment option

Screenshot: Mobile merchant cart page showing a product and a "Pay with MobilePay" button as payment option.

2. Customer enters phone number and logs in​

When they tap MobilePay, initiate a payment by calling POST:/api/v3/payments/.

  • Mobile device: The MobilePay app opens automatically.
  • Desktop: The landing page opens. The customer enters their phone number and hits Next to send the payment request to their app. A push notification appears on the customer's phone and the customer opens the MobilePay app.

MobilePay landing page showing phone number input field

Screenshot: MobilePay landing page. Left panel: phone number entry for a payment with "Remember my number" checkbox. Right panel: waiting screen with "Open MobilePay" and a countdown timer.

3. Customer approves the payment in the app​

The customer confirms the payment, and MobilePay Online reserves the payment and provides a confirmation.

Confirm payment MobilePay

Screenshot: Vipps/MobilePay app payment screen showing the amount to pay to the merchant, with a Visa Spendings card and a Pay button.

4. Confirm the order​

Once the payment is approved:

  • Mobile device: The store page/app reopens, confirming a successful order.
  • Desktop: The customer returns to the webshop, where the order confirmation is displayed.

Payment confirmation screen showing successful order

Screenshot: Merchant webshop order confirmation page showing "Thank you for your order" with a green checkmark. A confirmation email has been sent to the customer.

To check if the payment was authorized, poll using GET:/psp/v3/psppayments/{pspTransactionId}/details. See our polling guidelines for best practices.

5. Complete the order​

The merchant completes and ships the order to the customer.

6. Capture the payment​

Finish by capturing the payment through MobilePay Online.

Want more details?​

For technical details, see the MobilePay Online guide.

Last updated on