Download the PHP package 99x/craft-vipps-suite without Composer
On this page you can find all versions of the php package 99x/craft-vipps-suite. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download 99x/craft-vipps-suite
More information about 99x/craft-vipps-suite
Files in 99x/craft-vipps-suite
Package craft-vipps-suite
Short Description A Vipps Suite plugin for CraftCMS
License proprietary
Informations about the package craft-vipps-suite
Vipps Suite
A Vipps Suite plugin for CraftCMS. Supports recurring subscription agreements and one-time payments without requiring Craft Commerce.
Installation
Install via Composer:
Then install the plugin in Craft:
Configuration
- Navigate to Settings > Plugins > Vipps Suite in the Craft CMS Control Panel
- Configure the following credentials (preferably using environment variables):
- Client ID:
$VIPPS_CLIENT_ID - Client Secret:
$VIPPS_CLIENT_SECRET - Merchant Serial Number (MSN):
$VIPPS_MERCHANT_SERIAL_NUMBER - Subscription Key (Primary):
$VIPPS_SUBSCRIPTION_KEY_PRIMARY - Subscription Key (Secondary):
$VIPPS_SUBSCRIPTION_KEY_SECONDARY
- Client ID:
Environment Variables
Add these to your .env file:
Docker / DDEV Development Setup
Requirements
Current Environment:
- Craft CMS 4.14.0 or later
- PHP 8.0.2 or later
- MySQL 8.0.32 or later
Target Compatibility:
- Craft CMS 5.x (code is written to be forward-compatible)
- PHP 8.2+ (code is written to be forward-compatible)
- MySQL 8.x (already compatible)
Additional Requirements:
- Vipps merchant account
- Vipps API credentials (Client ID, Client Secret, Subscription Keys, MSN)
Note: While the plugin is developed on Craft CMS 4 and PHP 8.0.2, all code is written to be compatible with Craft CMS 5 and PHP 8.2 to ensure smooth future upgrades. See Forward Compatibility Guidelines for details.
Getting Vipps Credentials
- Sign up for a Vipps merchant account
- Access the Vipps Developer Portal
- Create an application to get OAuth credentials (Client ID and Client Secret)
- Obtain Subscription API keys (Primary and Secondary)
- Get your Merchant Serial Number (MSN) from the Vipps MobilePay business portal
Vipps Login Setup
The plugin includes a complete Vipps Login integration that allows users to authenticate using their Vipps account.
Using Vipps Suite in Templates
The plugin provides a global Twig variable vippsSuite that you can use in any template:
Vipps Login:
Agreement Templates:
Check Active Agreement:
Donations:
Unified Form:
Vipps Login Flow
- User clicks the login link generated by
vippsSuite.loginUrl() - User is redirected to Vipps authorization page
- User authenticates with Vipps
- Vipps redirects back to your site
- Plugin automatically creates or links the user account
- User is logged into Craft CMS
- User is redirected to the success URL (or error URL if login failed)
Next Steps
After installation and configuration:
- Configure Vipps Login callback URI in your Vipps portal
- Add Vipps Login button to your templates using
vippsSuite.loginUrl() - Create agreement templates in Vipps Suite > Agreement Templates
- Set up agreement template selection pages
- Configure webhook endpoints for agreement callbacks
- Set up charge scheduling for recurring payments
For detailed information, see the Technical Context documentation.