# Swish menu (Swish-meny) in Repejo

With a Swish-meny, the donor gives straight in the Swish app, without a form.
The donor opens your link and the Swish app shows your menu. There the donor
picks an amount and approves with BankID. The money goes straight to your
Swish number.

There is no API to call and no element to embed. You share a link. A gift from
the menu is a paid one-time Swish gift, with the same API, webhooks and
integrations as other one-time Swish gifts.

Human docs page: https://app.repejo.se/docs/swish-menu

The labels below are the Swedish ones from the back office.

## What you need

- A Swish number for one-time payments where Repejo is the technical supplier.
  A number that uses your own Swish certificates does not work. How to get one
  (in Swedish): https://app.repejo.se/docs/swish-onetime-setup
- A registration of your organisation at Swish, which you make in Repejo.

## Register your organisation at Swish

You do this once. Swish shows these details to the donor in the Swish app.

1. Go to **Inställningar → Betalningar → Swish-meny**.
2. Pick the number under **Swish-nummer**. The list shows only active
   one-time numbers where Repejo is the technical supplier.
3. Fill in **Organisationsnummer**, **Juridiskt namn**, **Webbadress** and
   **Telefonnummer**. The web address must start with `https://`.
4. If donors are to see a name other than the legal name, fill in
   **Namn som givaren ser**.
5. If you want a logo, upload it under **Logga**. Only PNG, at most 1 MB.
6. Click **Registrera hos Swish**.

If Swish refuses the registration, the page shows the error from Swish and
Repejo saves nothing. You cannot change the Swish number after the
registration, because all your Swish menus pay to it. To change the other
details, edit them and click **Spara ändringar**.

## Create a menu

A menu is a checkout of the type Swish-meny. It has no web form to design.

1. Go to **Checkouts** and click **Ny checkout**.
2. Pick **Swish-meny** and click **Nästa**. You can pick Swish-meny only after
   you have registered your organisation at Swish.
3. Fill in **Namn (internt)** and **Referens** and click **Nästa**.
4. Fill in **Swish-meddelande**. It is the message on the donor's Swish
   payment, at most 50 characters.
5. Fill in the menu in the **Swish-meny** box. The fields are below.
6. Click **Spara**.

When you save, Repejo registers the menu at Swish. If Swish refuses the menu,
the form shows the error from Swish and Repejo does not create the checkout.

## Fill in the menu

- **Titel på svenska** is required. **Titel på engelska**,
  **Undertitel på svenska** and **Undertitel på engelska** are optional. Each
  one is at most 100 characters.
- **Öppen från** and **Öppen till och med** set the period. The menu is open
  from 00:00 on the first day to 23:59:59 on the last day, Swedish time. A new
  menu starts today. When you change the first day, it cannot be before today.
  The last day cannot be before the first day.
- Under **Gåvobelopp (kr)** you enter at most 4 fixed amounts. Each amount must
  be above 0 and at most 150,000 kr, with at most two decimals. You can use
  each amount only once.
- Tick **Givaren kan välja eget belopp** to let the donor enter their own
  amount. The menu needs at least one fixed amount, or the custom amount
  ticked.
- Repejo refuses a gift below the checkout's **Minsta belopp**. This also
  applies to a fixed amount, so do not set a fixed amount below it.

## Choose the donor data Swish shares

Under **Uppgifter som Swish delar med er** you pick which of **Telefonnummer**,
**Namn** and **Personnummer** (personal identity number) Swish shares. Swish
shares the name and the personal identity number only for donors who are 18
or older.

- If Swish shares any data, you must tick at least one **Syfte med
  uppgifterna** (**Medlemskap** or **Skattereduktion**) and fill in
  **Adress till villkoren**. The address must start with `https://`. Your
  terms must say which data you get and why.
- Swish shares the name and the personal identity number only for donors who
  are 18 or older. For a younger donor you get only the phone number.
- **Lägsta ålder** is at least 13, and donors younger than that cannot give in
  the menu. If Swish shares the name or the personal identity number, it is
  required and at least 18. A new menu starts at 18.
- **Hämta givarens adress från SPAR med personnumret** needs
  **Personnummer**. Repejo gets the address from SPAR (the Swedish population
  register) after the donor has paid, if the donor has no address in Repejo.
  Your terms must say that you get the address.
- Under **Samtycke till kontakt**, pick **Inget samtycke** or
  **Alla givare får samtycke till marknadsföring**.

Repejo saves the donor's mobile number from the Swish payment when the gift is
paid, also if you do not tick **Telefonnummer**. Swish shares no email
address, so a new donor gets no thank-you email. The SMS to a new one-time
donor goes to the mobile number. It follows your organisation's template
unless you change it on the checkout's **Kommunikation** tab.

## Change a menu

Swish cannot change a menu. When you change a field in the **Swish-meny** box
and save, Repejo registers a new menu at Swish, and your link opens the new
menu. The SPAR choice, **Samtycke till kontakt** and the fields outside the
box register no new menu. If Swish refuses the change, the form shows the
error from Swish and Repejo saves none of your changes.

## The waiting screen

On the checkout's **Väntskärm** tab you choose what the page shows before
Swish opens:

- **Sekunder innan Swish öppnas** – 0–10 seconds on a phone. The default is 2.
- **Bakgrundsfärg** – the default is the checkout's primary colour. The text
  colour is picked automatically to be readable on it.
- **Använd organisationens logga** – on by default. Untick it to upload your
  own logo. Without an organisation logo the box cannot be ticked.
- **Rubrik** – filled in with the menu's title. Empty it if the page should
  have no heading. A later change of the menu's title does not change it.
- **Text** – optional.

**Förhandsvisa i mobil** and **Förhandsvisa på dator** show the page with the
values in the form. A menu that has not opened yet or has ended shows the
same colour, logo and heading.

## Share the link

You find the link to the menu, with a copy button and a QR code, at the top
of the checkout's **Länkar** tab. The link is `https://app.repejo.se/swish-meny/<short code>`
and goes through Repejo, so Repejo can count how many people open it.

- On a phone, the page shows the waiting screen with "Swish öppnas…", and
  opens the Swish app when the waiting time has passed. The page then also
  shows the button **Öppna Swish** in case the app does not open.
- On a computer, the page shows the same colour, logo, heading and text with a
  QR code that the donor scans with the phone camera. A computer does not wait.
- The page has no thank-you screen. The donor pays in the Swish app, and the
  app shows that the gift was sent.
- To count opens per channel or mailing, open the **Länkar** tab and click
  **Ny checkoutvariant**. Each variant has its own link to the same menu.
- Repejo also counts a link preview, for example in a chat app, as an open.
- The page sets no cookies and loads no tracking. A paid gift sends no
  purchase event to Meta or Google Analytics.

## Where you find the gifts

A gift from the menu is a paid one-time gift with Swish on the menu's
checkout. You find the donor and the gift in Repejo like other gifts, and you
can export them. The webhook `receivable.created` has `product_type` set to
`donation`.

Swish shares no email address and no postal address. If Repejo already knows a
donor with the same mobile number, the gift goes to that donor. An address
from SPAR arrives after `receivable.created`, and no webhook sends it.

## Limits

- Repejo supports only one-time gifts through Swish-meny, not sales or votes.
- Only SEK.
- If something goes wrong, the donor sees only a general error in the Swish
  app.
