Skip to content

Vipps MobilePay Donor

1. Register and create account with MobilePay

Step 1: You need to register a MobilePay merchant account (Visit external site. The link opens in a new tab.) for payment integration and recurring payments.

Step 2: Order recurring payments from the portal:

  1. Select: Order solution -> Advanced Solutions -> Recurring payments
  2. Select: Who is going to integrate the solution?: We’ll use an official partner
  3. Select: Partner: Muuks Creative
  4. Select: Where are you going to sell your products or services?: On our website
  5. Fill rest of the form with your information.

Step 3: Order epayments from the portal:

  1. Select: Order solution -> Advanced Solutions -> Payment Integration
  2. Select: Who is going to integrate the solution?: We’ll use an official partner
  3. Select: Partner: Muuks Creative
  4. Select: Where are you going to sell your products or services?: On our website
  5. Fill rest of the form with your information.

2. Install the MobilePay Donation plugin

  1. In the admin for your WordPress site, click on “Add New Plugin” in the “Plugins” menu.
  2. Then click “Upload Plugin” button next to “Add Plugins” title.
  3. Choose the mobilepay-donor.zip you downloaded after the purchase
  4. Click “Install Now” button
  5. After the installation finishes – Activate the plugin through the “Plugins” screen in WordPress.

3. Activate your license

On the “Plugins” screen find the “Mobilepay Donor” and click “Manage License” link. Add your license key.

4. Configure plugin settings

Go to Settings > Mobilepay Donor to configure settings for the plugin.

Button background color (HEX color code) – Donate form’s buttons background color. This setting is only used when “Enable plugins styles sheet” is enabled.

Button text color (HEX color code) – Donate form’s buttons text color. This setting is only used when “Enable plugins styles sheet” is enabled.

Text color (HEX color code) – Donate form’s buttons labels color. This setting is only used when “Enable plugins styles sheet” is enabled.

Sender email address – Email address used as sender address for all the emails which are sent to donors.

Organization name – Name used as sender name for all the emails which are sent to donors.

Your donation was successful page – After successful payment, plugin redirects user to this page.

Your Terms and Conditions page – If you want that user must consent to your terms and conditions, select a page

Merchant MSN number (MSN) – Your “Merchant Serial Number” from the Developer tab on https://portal.vippsmobilepay.com

Client ID (client_id) – Find your account under the “Developer” tab on https://portal.vippsmobilepay.com/ and choose “Show keys”. Copy the value of “client_id”

Secret Key (client_secret) – Find your account under the “Developer” tab on https://portal.vippsmobilepay.com/ and choose “show keys”. Copy the value of “client_secret”

Subscription Key (Ocp-Apim-Subscription-Key) – Find your account under the “Developer” tab on https://portal.vippsmobilepay.com/ and choose “show keys”. Copy the value of “Vipps-Subscription-Key”

Test Merchant MSN number (MSN) – Normally you don’t need to input this as it’s needed only for testing purposes.

Test Client ID (client_id) – Normally you don’t need to input this as it’s needed only for testing purposes.

Test Secret Key (client_secret) – Normally you don’t need to input this as it’s needed only for testing purposes.

Test Subscription Key (Ocp-Apim-Subscription-Key) – Normally you don’t need to input this as it’s needed only for testing purposes.

Test mode – Make sure the Test mode is NOT enabled as it’s needed only for testing purposes.

Currency – Select your currency. All current MobilePay currencies are supported: Danish krone (DKK), Euro (EUR), Norwegian krone (NOK) and Swedish krona (SEK).

Enable plugins styles sheet – Disable this if you want to create the CSS styles yourself for the donation form. Enable to use plugin’s styles for the donation form.

5. Add the donation form to your site

Add the donor_form shortcode to pages / posts where you want. Use amount1, amount2 and amount3 parameters to define the amounts for the selectable donation amounts.

[donor_form amount1="10" amount2="20" amount3="30"]

That’s it! Now you’re ready to receive donations!

How to use the plugin

You can find donor registry from the WordPress admin under MobilePay donors menu.

You can open each donator and depending if it’s onetime or monthly donation you have different options to edit.

Monthly donations

You can edit the name, email, phone number and donation amount. New donation amount is updated to MobilePay agreement after the post is saved. You can refund individual charges.

Each monthly donator has also their own individual page on your website which is accessed from the MobilePay application, from this page they can stop their monthly donation agreement with you. In case you need to send this link for the donor you can find the link titled “Donors page”.

Onetime donations

You can only refund the onetime amount.

Customization of the emails with filters

Below is the list of filters which can be used to customize the default email outputs. Customization with add_filter function can be added to your themes functions.php.

mobilepay_donor_email_start_html – filter to modify the default HTML starting all emails. Default output is: <div style="background-color: #f9f9f9; padding: 2rem 1rem; width: 100%; height: auto; box-sizing: border-box;"><div id="wrapper" style="font-size: 100%; max-width: 600px; margin: 0 auto; background-color: #ffffff; padding: 2rem; box-sizing: border-box;">

mobilepay_donor_email_end_html – filter to modify the default HTML ending all emails. Default output is: </div> <!--Close wrapper--></div> <!--Close body-->

mobilepay_donor_email_subject_monthly_donation_success – filter to change the subject of the email which is sent to admin email address after successful monthly donation.

mobilepay_donor_email_body_monthly_donation_success – filter to change the body of the email which is sent to admin email address after successful monthly donation.

mobilepay_donor_email_subject_donation_reminder – filter to change the subject of the reminder email which is sent to the monthly donor who did not finalize the payment in MobilePay application.

mobilepay_donor_email_body_donation_reminder – filter to change the body of the reminder email which is sent to the monthly donor who did not finalize the payment in MobilePay application.

mobilepay_donor_email_subject_onetime_donation_success – filter to change the subject of the email which is sent to the one time donor after successful payment.

mobilepay_donor_email_body_onetime_donation_success – filter to change the body of the email which is sent to the one time donor after successful payment.

mobilepay_donor_email_subject_monthly_donation_success – filter to change the subject of the email which is sent to the monthly donor after successful payment.

mobilepay_donor_email_body_monthly_donation_success – filter to change the body of the email which is sent to the monthly donor after successful payment.

Translations

Currently, the plugin is translated into English, Swedish and Finnish. You can easily add your own language with the steps below.

Option 1: Install Loco Translate plugin to translate the strings

  1. Install Loco Translate plugin to your website
  2. Open Loco Translate > Plugins
  3. Click “External Content Consent” on the “Translate plugins” list
  4. Add your missing language and translate the English strings to your language

Option 2: Create and translate your own .po and .mo files e.g. with Poedit (Visit external site. The link opens in a new tab.)

1. Find Your “Locale Code”
This is the standard code for your language and region.

For German (Germany), it is de_DE.

For French (France), it is fr_FR.

You can find a complete list on the official WordPress translation teams page (Visit external site. The link opens in a new tab.).

The file names MUST follow this exact format:
mobilepay_donor-[locale_code].po
mobilepay_donor-[locale_code].mo

e.g for French:
mobilepay_donor-fr_FR.po
mobilepay_donor_FR.mo

2. Upload your own .po and .mo files

  1. Navigate to your WordPress installation’s /wp-content/ directory e.g. with FileZilla FTP program.
  2. Look for a folder named languages. If it doesn’t exist, create it.
  3. Inside the languages folder, look for a folder named plugins. If it doesn’t exist, create it.
  4. Upload your two correctly named files (.po and .mo) into this /wp-content/languages/plugins/ directory.

Warning: Avoid This Location DO NOT upload your files to /wp-content/plugins/[plugin-name]/languages/. While translations can work from this folder, the entire plugin directory is overwritten and deleted when the plugin is updated, and you will lose your custom translation files.

Purchase Vipps MobilePay Donor