This page explains how to add MobilePay to your existing iOS Components integration.
Requirements
Requirement | Description |
---|---|
Integration type | Make sure that you have built your iOS Components integration. |
Webhooks | To make MobilePay payouts, you need to configure recurring lifecycle webhooks. |
Limitations | The MobilePay payout feature is experimental, and supported only with the /payments endpoint. See the full payout limitations. |
Setup steps | Before you begin, add MobilePay in your test Customer Area. |
API reference
Select which endpoint you are using:
Component configuration
v5.0.0 or later
If your integration uses iOS Components v5.0.0 or later, configure and create an instance of the MobilePay Component:
v4.x.x
If your integration uses an earlier version of iOS Components:
There are no configuration steps specific to MobilePay required for Components.
Test and go live
MobilePay cannot be tested in the test environment. You must make penny test (low-amount) payments in the live environment.
-
Submit a request for MobilePay in your live Customer Area.
-
After MobilePay is added to your live Customer Area, do the following for each test payment:
- Make a MobilePay payment for a low amount.
- Get the AUTHORISATION webhook on your server. It includes the status of the payment.
- In your live Customer Area, go to Transactions > Payments to see the status of the payment.
Test payouts to MobilePay wallets
The MobilePay payout feature is experimental, and supported only with the /payments
endpoint.
Do the following to test MobilePay payouts:
-
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
-
-
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.