MobilePay Android Redirect Component

If you have an existing Android Components integration, you can use our Redirect Component to redirect the shopper to the MobilePay app on their mobile device to complete the payment. As with other redirect payment methods, you need to handle the redirect 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

Include MobilePay in the list of available payment methods. You do not need to collect any information from the shopper 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.

The response contains paymentMethod.type: mobilepay.

Make a payment

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

• paymentMethod.type: mobilepay
• 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).

curl https://checkout-test.adyen.com/checkout/v68/payments \
-H 'x-api-key: ADYEN_API_KEY' \
-H 'content-type: application/json' \
-d '{
  "merchantAccount":"ADYEN_MERCHANT_ACCOUNT",
  "reference":"YOUR_ORDER_NUMBER",
  "amount":{
    "currency":"DKK",
    "value":1000
  },
  "paymentMethod":{
    "type":"mobilepay"
  },
  "telephoneNumberOptional. Send this for a better shopper experience.": "+4512345678",
  "returnUrl":"adyencheckout://your.package.name"
}'

The /payments response includes the action object with information that you must use to redirect the shopper.

{
  "resultCode":"RedirectShopper",
  "action":{
    "paymentMethodType":"mobilepay",
    "method":"GET",
    "url":"https://checkoutshopper-test.adyen.com/checkoutshopper/checkoutPaymentRedirect?redirectData=...",
    "type":"redirect"
  }
}

Handle the redirect

1. Use the Redirect Component to redirect the shopper to the MobilePay app.

2. After the shopper returns to your app, make a POST /payments/details request from your server, providing:

   • details: The actionComponentData.details object from the Redirect Component.

curl https://checkout-test.adyen.com/checkout/v68/payments/details \
-H 'x-api-key: ADYEN_API_KEY' \
-H 'content-type: application/json' \
-d '{
     "details": {
       "redirectResult": "eyJ0cmFuc1N0YXR1cyI6IlkifQ=="
   }
}'

You receive a response containing:

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

{
      "resultCode": "Authorised",
      "pspReference": "PPKFQ89R6QRXGN82"
}

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.

Request MobilePay for the live environment

Submit a request for MobilePay in your live Customer Area.

Make test payments.

Use the following credentials for your test payments:

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.

See also