> **Description:** URL format for Vipps MobilePay donation links and QR codes, including the optional reference parameter.

> **AI agent:** Read [https://developer.vippsmobilepay.com/docs/knowledge-base/ai-tools.md](https://developer.vippsmobilepay.com/docs/knowledge-base/ai-tools.md) first. It covers keeping API keys and secrets out of generated code.

> **Full site overview:** For every page in this documentation, read [https://developer.vippsmobilepay.com/llms.txt](https://developer.vippsmobilepay.com/llms.txt).

# Donation links and QR codes

A donation link opens the Vipps  or MobilePay  donation journey in the app. The same URL can be shared as a link or encoded as a QR code.

These links apply only to sales units with the *Donations* product. Donation links and QR codes can also be created in the [business portal](https://portal.vippsmobilepay.com/).

## URL format

```text
https://{domain}/donations/{alias}
https://{domain}/donations/{alias}?reference={reference}
```

| Market | Domain |
|--------|--------|
| Norway | `qr.vipps.no` |
| Denmark | `qr.mobilepay.dk` |
| Finland | `qr.mobilepay.fi` |

| Part | Required | Description |
|------|----------|-------------|
| `{alias}` | Yes | Short numeric ID of the Donations sales unit (Vippsnummer / MobilePay-nummer), shown in the [business portal](https://portal.vippsmobilepay.com/). Digits only, 1-6 characters. Leading zeros are significant (`0011` is not the same as `11`). |
| `reference` | No | Optional tracking value for campaigns, field recruiters, or similar. |

**WARNING**

Use only the domains and path format above. Links on other hosts are not opened as donations inside the Vipps or MobilePay app.

## The `reference` parameter

| Rule | Detail |
|------|--------|
| Allowed characters | Letters `A-Z` / `a-z`, digits `0-9`, hyphen `-`, underscore `_`, and spaces |
| Maximum length | 50 characters |
| Encoding | URL-encode values as needed (for example, spaces as `%20` or `+`) |

Examples of valid references: `campaign-2024`, `field-recruiter-mary`, `event charity run`.

## Examples

Bare link for alias `1234` in Norway:

```text
https://qr.vipps.no/donations/1234
```

Link with a reference:

```text
https://qr.vipps.no/donations/1234?reference=campaign-2024
```

Denmark and Finland use the same path shape on their market domains:

```text
https://qr.mobilepay.dk/donations/1234?reference=campaign-2024
https://qr.mobilepay.fi/donations/5678?reference=event-charity-run
```

## Creating a QR code

Encode the full universal link (including any `reference` query parameter) as the QR code payload.

Any standard QR generator works, as long as the encoded string is the `https://{domain}/donations/...` URL for the correct market.

**TIP**

Branded donation QR codes are also available from the [business portal](https://portal.vippsmobilepay.com/).