# Vipps MobilePay Gateway Pro Feature Taking Vipps MobilePay at the till needs [WCPOS Pro](/ko/getting-started/pro-license.md). Without Pro, the gateway still works on your online store's checkout. The customer pays with the Vipps or MobilePay app on their own phone. They scan a QR code on your screen, or approve a payment request you send to their phone. No card reader is needed. The gateway runs on the checkout's **Legacy** tab, on your store's own payment page. Your store needs the gateway set up first. See [Set up Vipps MobilePay](#setup). ## Take a Vipps payment[​](#take-payment "Take a Vipps payment으로 직접 링크") Vipps takes the whole order in one payment. Once part of the order is paid, the Legacy tab says **A legacy gateway can't be used once a payment has been taken** and you can't choose Vipps: [cancel that payment](/ko/sell/take-payment/cancel-payment.md) first, or take the rest another way. Press **Checkout**, open the **Legacy** tab and choose **Vipps MobilePay**. Its controls open under it. Then show the customer [a QR code](#qr), or [send the request to their phone](#send-to-phone). ![The checkout's Legacy tab with Vipps MobilePay chosen: the phone number field, the Generate QR Code and Send to Phone buttons, the amount remaining and Process Payment](/img/2.x/payment/gateways/vipps-mobilepay/en/tablet-light-regular--v-1-vipps-selected.png)1234567 1. **Legacy** tab — gateways that run on their own payment page. See [The Legacy Tab](/ko/sell/take-payment/legacy-tab.md). 2. **Vipps MobilePay** — the gateway. Your store may give it another name; see [Settings](#settings). 3. **Phone number (optional)** — only for **Send to Phone**. Leave it empty for a QR code. 4. **Generate QR Code** — shows a code for the customer to scan. See [With a QR code](#qr). 5. **Send to Phone** — sends the payment request to the number you typed. It lights up once there's a number. See [Send it to their phone](#send-to-phone). 6. **Remaining** — what the customer approves in the app: the whole order. 7. **Process Payment** — you don't need it for Vipps. The sale completes by itself when the customer approves. ### With a QR code[​](#qr "With a QR code으로 직접 링크") 1. Press **Generate QR Code**. A QR code appears under the buttons, with **Waiting for payment...** under it. 2. Turn the screen to the customer. They scan the code with the Vipps or MobilePay app and approve the payment. 3. The till checks with Vipps every two seconds. When the customer approves, the page says **Payment successful!** and the receipt screen opens by itself, the same as for any [paid sale](/ko/getting-started/make-sale.md#paid). While the till waits, both buttons are greyed out and a **Cancel Payment** button shows under them. If nobody approves within five minutes, the page says **Payment expired. Please try again.** ### Send it to their phone[​](#send-to-phone "Send it to their phone으로 직접 링크") Type the customer's phone number and press **Send to Phone**. Then one of two things happens: * **Direct Push:** the request appears in their Vipps app, and they approve it there. The page waits, and finishes, as for a QR code. * **The Vipps page opens in a new window**, or the page first asks you to press again. That's expected when Vipps hasn't turned on Direct Push for your store: open **Asked to press Send to Phone again?** below. **Norwegian numbers only.** Type eight digits, or put `47`, `+47` or `0047` in front. An eight-digit number is always read as Norwegian, so for a MobilePay customer in Denmark or Finland, use the QR code. Asked to press Send to Phone again? The page says **Direct push not available for your account. Click Send to Phone again.** when Vipps hasn't turned on [Direct Push](#enabling-direct-push) for your account. 1. Press **Send to Phone** again. 2. A new window opens on the Vipps page for that number, and the request goes to the customer from there. 3. When the customer has paid, that window says **Payment complete** and closes by itself. If the browser won't close it, it moves on to your store's home page: close it and go back to the checkout. From then on, every **Send to Phone** opens that window, until you [turn on Direct Push](#enabling-direct-push). In **Test Mode** there's no window: the page asks you to press again every time, so test with the QR code. ### Stop a payment[​](#cancel "Stop a payment으로 직접 링크") Press **Cancel Payment** while the till is waiting. The payment is cancelled with Vipps and the page says **Payment cancelled.** Nothing was taken. Press **Generate QR Code** or **Send to Phone** to try again, or pay another way: pick another gateway on the Legacy tab, or go back to the **Payments** tab. The same **Payment cancelled.** shows when the customer declines in their app. ## If something goes wrong[​](#goes-wrong "If something goes wrong으로 직접 링크") **Payment expired. Please try again.** Five minutes passed with no answer from the customer. Press **Generate QR Code** or **Send to Phone** again. **Payment cancelled.** and you didn't press Cancel. The customer declined in their app. Check with them, then try again. **Invalid phone number. Use a Norwegian number, e.g. 4741234567.** The number isn't a Norwegian mobile number. Check it, or use the QR code. **Popup blocked. Please allow popups and try again.** The browser stopped the Vipps window from opening. Allow pop-ups for your store's site in the browser settings, then press **Send to Phone** again. **Network error. Please check your connection.** The till couldn't reach your store to start the payment. Check the till's connection, then press **Generate QR Code** or **Send to Phone** again. **Failed to create Vipps payment.** Your store couldn't start the payment with Vipps. Ask the customer whether they approved a payment in their app. If they did, ask your store owner to check Vipps before you take another payment. If not, take this sale another way, and ask your store owner to check the gateway's setup. For the store owner: check the setup and the log * The four keys and **Test Mode** in [Settings](#settings): live keys with Test Mode off, or test keys with it on. * Your site runs on HTTPS. * The order is in a currency Vipps takes. See [Where it works](#supported-markets). * For the reason, turn on **Debug Log** and try again. It shows under **Show Log** on the payment page, and in `WooCommerce > Status > Logs` under the source `wcpos-vipps`. Check Vipps before you take payment again **Vipps payment was accepted, but … Please try again.** The customer's payment went through at Vipps, but WooCommerce didn't mark the order paid. Before you take a new payment, find this payment in the [Vipps MobilePay portal](https://portal.vippsmobilepay.com/), so the customer doesn't pay twice. **Send to Phone opens a window instead of going straight to the app.** Your account is on **Web Redirect**. That works, with one extra step for the customer. To go straight to the app, see [Turn on Direct Push](#enabling-direct-push). ## Set up Vipps MobilePay[​](#setup "Set up Vipps MobilePay으로 직접 링크") Before you start You need a Vipps MobilePay merchant account with the ePayment API, its four API keys, [WCPOS Pro](/ko/getting-started/pro-license.md), and a site on HTTPS, which the Vipps API requires. The store owner installs the gateway, adds the four keys and turns it on for the POS. It then shows on the checkout's Legacy tab. For the store owner: install and turn on the gateway 1. **Install** WCPOS Vipps MobilePay from `WP Admin > POS > Settings > Extensions`. See [Installing an Extension](/ko/manage-store/add-ons.md#installing-an-extension). Or download the **plugin zip asset** (not the source-code zip) from the [releases page](https://github.com/wcpos/wcpos-vipps/releases) and upload it in `Plugins > Add Plugin`, then **Upload Plugin**. 2. **Add your keys.** Open `WP Admin > WooCommerce > Settings > Payments > WCPOS Vipps MobilePay` and enter the **Merchant Serial Number**, **Client ID**, **Client Secret** and **Subscription Key** from the [Vipps MobilePay portal](https://portal.vippsmobilepay.com/). Save. 3. **Turn it on for the POS** in `WP Admin > POS > Settings > Checkout`. See [Enabling a Gateway](/ko/settings/checkout.md#enabling-a-gateway). It then appears on the checkout's Legacy tab. Already using the official Vipps plugin? If [Checkout with Vipps MobilePay](https://wordpress.org/plugins/woo-vipps/) is set up on your site, WCPOS Vipps MobilePay copies its keys, test keys included, the first time it loads. Check them and save. The **Enable/Disable** box on the WooCommerce screen is for your online store's checkout only. The POS uses the gateway once it's turned on in Checkout Settings, whether that box is ticked or not. ### Settings[​](#settings "Settings으로 직접 링크") These are on `WP Admin > WooCommerce > Settings > Payments > WCPOS Vipps MobilePay`. Most stores only fill in the four keys. The rest start right for the till: the money is taken as soon as the customer approves, and **Send to Phone** tries Direct Push first. All settings: name and description, keys, Auto Capture, Phone payment method, Debug Log and Test Mode | Setting | What it does | | ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Enable/Disable** | Offers Vipps MobilePay on your online store's checkout. Not needed for the POS. Off to start with. | | **Title** | The gateway's name on the Legacy tab and online. Starts as `Vipps MobilePay`. Checkout Settings can give the POS its own title. | | **Description** | The line under the name. Starts as "Pay with Vipps MobilePay via QR code or push notification." | | **Merchant Serial Number**, **Client ID**, **Client Secret**, **Subscription Key** | Your live keys from the Vipps MobilePay portal. The gateway isn't offered until all four are filled in (with **Test Mode** on, the four **Test** keys instead). | | **Auto Capture** | On to start with: the money is taken as soon as the customer approves. Turn it off only if you capture reserved payments yourself, outside WCPOS. | | **Phone payment method** | How **Send to Phone** reaches the customer. **Direct Push** (the start) goes straight to their Vipps app. **Web Redirect** opens the Vipps page in a new window. Switches to **Web Redirect** by itself when Vipps refuses Direct Push (not in Test Mode). | | **Debug Log** | Writes each payment step to `WooCommerce > Status > Logs`, and adds a **Show Log** panel under the payment controls. Turn it on to find out why a payment fails, then off again. | | **Test Mode** | Sends payments to Vipps' test system instead, using the four **Test** keys below it. Turn it off before you take real payments. | ### Turn on Direct Push[​](#enabling-direct-push "Turn on Direct Push으로 직접 링크") With Direct Push, **Send to Phone** goes straight to the customer's Vipps app, with no extra window. Vipps has to allow it on your account first, and then the store owner switches the gateway back to it once. For the store owner: ask Vipps, then switch back to Direct Push 1. Log in to the [Vipps MobilePay portal](https://portal.vippsmobilepay.com/). 2. Contact your Vipps key account manager, partner manager or customer service. 3. Tell them: "I need PUSH\_MESSAGE enabled on my MSN for use with a POS integration". MSN is your **Merchant Serial Number**. 4. When they confirm, set **Phone payment method** back to **Direct Push** and save. The gateway doesn't switch back by itself. While it's on **Web Redirect**, the setting's own description reminds you how to turn Direct Push on. In **Test Mode**, a refused Direct Push leaves the setting as it is and doesn't open the Vipps page: each **Send to Phone** asks you to press again. Test with the QR code instead. ### Refunds[​](#refunds "Refunds으로 직접 링크") Refund the order from the POS and choose **Refund to Vipps MobilePay**, or refund it from the WooCommerce order screen. The money goes back to the customer through Vipps. See [Refunds](/ko/manage-store/orders/refund-rules.md). If Vipps refuses, the refund isn't recorded and the message says **Vipps refund request failed.** Try again, or refund in cash. ## Where it works[​](#supported-markets "Where it works으로 직접 링크") | Country | App | Currency | | ---------------- | --------- | -------- | | Norway | Vipps | NOK | | Denmark, Finland | MobilePay | DKK, EUR | The order has to be in one of these currencies, and your merchant account decides which of them you can take. **Send to Phone** works with Norwegian numbers only; the QR code works everywhere. ## Getting help[​](#getting-help "Getting help으로 직접 링크") * Account and keys: Vipps MobilePay customer service. * The Vipps API: the [Vipps MobilePay developer docs](https://developer.vippsmobilepay.com/). * A fault in the gateway: the [GitHub repository](https://github.com/wcpos/wcpos-vipps). ## Related Documentation[​](#related-documentation "Related Documentation으로 직접 링크") [The Legacy TabGateways that run on their own payment page](/ko/sell/take-payment/legacy-tab.md) [Checkout SettingsTurn gateways on for the POS](/ko/settings/checkout.md) [RefundsGive money back from the POS](/ko/manage-store/orders/refund-rules.md)