MobilePay Android Drop-in

Our Android Drop-in renders MobilePay in your payment form, and redirects the shopper to the MobilePay app on their mobile device to complete the payment. As with other redirect payment methods, you need to check the payment result after the shopper returns to your app.

To give your shoppers a better experience, you can also send the shopper's telephone number when making the payment, so they no longer have to provide this later when they are redirected to MobilePay.

Requirements

Show MobilePay in your payment form

Drop-in uses the countryCode and the amount.currency from your /paymentMethods request to show the available payment methods to your shopper.

To show MobilePay in your payment form:

1. Make a POST /paymentMethods request specifying one of the following combinations:

   Country/region	countryCode	amount.currency	amount.value
   Denmark	DK	DKK	The value of the payment, in minor units.
   Finland	FI	EUR	The value of the payment, in minor units.

2. When the shopper proceeds to pay, Drop-in returns the paymentComponentData.paymentMethod.

   Pass the paymentComponentData.paymentMethod to your server — these are the shopper details that you need to make the payment.

Make a payment

1. From your server, make a POST /payments request, specifying:

   • paymentMethod: The paymentComponentData.paymentMethod from your client app.
   • telephoneNumber: Optional. If you already have your shopper's phone number, send it in the request so they no longer have to provide this later when they are redirected to MobilePay.
   • returnUrl: URL to where the shopper should be redirected back to after they complete the payment. Get this URL from the Component in the RedirectComponent.getReturnUrl(context).

2. In the /payments response, check the action object for the information that you must use to redirect the shopper.

   If your integration is set up correctly, the action object is passed from your server to the client.

Payment with payout token creation

To make a MobilePay payment and generate a token for future payouts to MobilePay wallets:

1. Make sure that you have set up the recurring lifecycle webhook.

2. Make a /payments request as usual, but include the parameters to create a token:

   • telephoneNumber
   • shopperReference
   • enablePayout set to true

3. When you receive the recurring lifecycle webhook for the payment, save the storedPaymentMethodId (the token) for your customer, identified by the shopperReference.

4. When you want to make a payout to the shopper's MobilePay wallet, send a POST /transfers request specifying the payout token in the counterparty.card.cardIdentification field.

Check the payment result

Drop-in redirects the shopper to complete the payment. When the shopper returns back to your app, Drop-in provides the actionComponentData object.

From your server, make a POST /payments/details request providing:

• details: The actionComponentData.details object from Drop-in.

You receive a response containing:

• resultCode: Use this to present the payment result to your shopper.
• pspReference: Our unique identifier for the transaction.

Present the payment result

Use the  resultCode that you received in the /payments/details response to present the payment result to your shopper.

The resultCode values you can receive for MobilePay are:

If the shopper failed to return to your website or app, wait for the AUTHORISATION webhook to receive the outcome of the payment:

Test and go live

MobilePay cannot be tested in the test environment. You must make penny test (low-amount) payments in the live environment.

1. Submit a request for MobilePay in your live Customer Area.

2. After MobilePay is added to your live Customer Area, do the following for each test payment:

   1. Make a MobilePay payment for a low amount.
   2. Get the AUTHORISATION webhook on your server. It includes the status of the payment.
   3. In your live Customer Area, go to Transactions > Payments to see the status of the payment.

Test payouts to MobilePay wallets

Do the following to test MobilePay payouts:

1. Get a test app following the instructions in the VippsMobilePay documentation. When prompted for a phone number and NIN (national identity number), use one of the following sets:

   • NIN 0407640091
     Phone +45 22105837

   • NIN 0702860109
     Phone +45 34817154

   • NIN 0111500196
     Phone +45 73920021

2. Test your integration end-to-end:

   • Make a test payment that generates a payout token, using the Vipps MobilePay test app to simulate the customer side.
   • Check that you receive and process the recurring lifecycle webhook.
   • Make a Transfers API request using the token that you receive in the webhook.

See also