MobilePay payments
MobilePay is a single-use card wallet payment method used in Denmark and Finland. It allows customers to authenticate and approve payments using the MobilePay app.
During the processing of a MobilePay payment, Stripe performs a card transaction using the card data we receive from MobilePay. The processing of the card transaction is invisible to your integration, and you can only see the outcome of the transaction.
Stripe immediately notifies you when the payment succeeded or failed.
Caution
Stripe automatically presents your customers payment method options by evaluating their currency, payment method restrictions, and other parameters. We recommend that you configure your payment methods from the Stripe Dashboard using the instructions in Accept a payment.
If you want to continue manually configuring the payment methods you present to your customers with Checkout, use this guide (for example, to accept payments in Subscription mode). Otherwise, migrate to the dashboard.
Use this guide to enable MobilePay on Checkout, our hosted checkout form, and learn the differences between accepting a card payment and a MobilePay payment.
Determine compatibility
A Checkout Session must satisfy all of the following conditions to support MobilePay payments:
- Prices for all line items must be expressed in Euro, Danish Krona, Swedish Krona or Norwegian Krona (currency codes
eur
,dkk
,sek
ornok
).
Set up StripeServer-side
First, you need a Stripe account. Register now.
Use our official libraries for access to the Stripe API from your application:
Accept a payment
Note
This guide builds on the foundational accept a payment Checkout integration.
Enable MobilePay as a payment method
When creating a new Checkout Session, you need to:
- Add
mobilepay
to the list ofpayment_method_types
- Make sure all your
line_items
use theeur
,dkk
,sek
ornok
currency
Fulfill your orders
After accepting a payment, learn how to fulfill orders.
Failed payments
MobilePay transactions can fail if the underlying card transaction is declined. Learn more about card declines.
In these cases, the PaymentMethod is detached and the PaymentIntent object’s status automatically transitions to requires_payment_method
.
Other than a payment being declined, for a MobilePay PaymentIntent with a status of requires_action
, customers must complete the payment within 5 minutes. If no action is taken after 5 minutes, the PaymentMethod detaches and the PaymentIntent object’s status automatically transitions to requires_payment_method
.