Setup
Install AI tools
Give your assistant up-to-date guidance for our APIs, with our plugin or without it.
The plugin is still under development. See the AI tools page for details.
- Claude Code
- Cursor
- Codex
- Without installing
Run both commands, in order.
claude plugin marketplace add vippsas/agent-toolkit
claude plugin install vipps-developer@agent-toolkit
Open Settings, then Plugins.
Add vippsas/agent-toolkit as a plugin marketplace, then install the "vipps-developer" plugin.
For the app, add the marketplace "vippsas/agent-toolkit" and then install "vipps-developer". For the CLI, run the following commands.
codex plugin marketplace add vippsas/agent-toolkit
codex plugin add vipps-developer@agent-toolkit
Paste this into any assistant.
Read https://github.com/vippsas/agent-toolkit/blob/main/plugins/vipps-developer/README.md for Vipps MobilePay integration guidance.
For troubleshooting, see the full instructions.
This page is for PSPs integrating with the ePayment, Recurring, or Vipps PSP APIs. If you are a MobilePay Online PSP, go to MobilePay Online API.
Sign up as a PSP partner​
Before you can use this API, you must sign up as a Payment Service Provider with Vipps MobilePay.
Sign up as a PSP partner on the Vipps MobilePay website. Once onboarding is complete, you will receive an email from the partner team with your test credentials.
Your credentials​
After signing up, you will receive the following credentials needed to authenticate with the API:
| Credential | Description |
|---|---|
client_id | Client ID, required for getting the access token. |
client_secret | Client secret, required for getting the access token. |
Ocp-Apim-Subscription-Key | PSP subscription key, required for all requests. |
PSP-ID | Your PSP ID provided by Vipps MobilePay, required for all requests. |
API keys and secrets should never be shared publicly or committed to source control. Use encrypted mail or a secrets manager to handle them securely.
The PSP Merchant API uses the standard Vipps MobilePay authentication flow. For a full guide covering authentication and access tokens, see Integration and testing.
Test environment​
All development and testing should be done against the test environment before going live.
- Test server:
https://apitest.vipps.no - Test app: Download and login instructions are on the test apps page.
Before you start testing, familiarize yourself with test environment limitations, restrictions, and best practices.
Next steps​
- Quick start: Run the basic PSP Merchant API examples.
- API guide: Learn how the PSP Merchant API works.
- API reference: Browse the full API specifications.