Vipps/MobilePay

This guide will help you obtain your Vipps/MobilePay accounting-partner API credentials and connect Vipps/MobilePay as a data source in Payrails to ingest funds, fees, and payout data. With the self-serve flow you configure the integration yourself in the Payrails portal.

Prerequisites

• An active Vipps/MobilePay merchant account.
• A point of contact who can provision accounting-partner API access, such as your Vipps/MobilePay account manager or accounting-partner administrator.

Step-by-step instructions

Vipps/MobilePay data is ingested through the Report API using accounting-partner credentials. Do not use the merchant sales-unit API keys used for taking payments. Accounting-partner credentials use OAuth2 client credentials and provide read-only access to funds and fee reports across all of your merchant's ledgers, so you need one credential pair regardless of the number of currencies or ledgers you operate.

Step one: request accounting-partner API credentials from Vipps/MobilePay

1. Contact your Vipps/MobilePay account manager or accounting-partner administrator.
2. Request an accounting-partner Client ID and Client Secret with read-only Report API access for funds and fee reports.
3. Store the credentials securely after Vipps/MobilePay provisions them. Treat the Client Secret like a password, as you typically cannot retrieve it again later.

Step two: add the Vipps/MobilePay integration in the Payrails portal (self-serve)

1. Log in to the Payrails dashboard and open Settings → Integrations → Data.
2. Click Add instance (top-right).
3. In New instance, select provider: Vipps/MobilePay and click Continue.
4. On the Configure account screen, fill in:
   • Integration instance name — a unique label.
   • Start Date — today or tomorrow. Payrails cannot backfill through the self-serve flow; contact your Payrails account manager if you need historical data.
   • Client ID — your Vipps/MobilePay accounting-partner Client ID.
   • Client Secret — your Vipps/MobilePay accounting-partner Client Secret. Payrails stores this value masked.
5. Click Save account. The instance appears in the Data integrations list and Payrails begins ingesting data.