Access Token API

View as Markdown (opens in a new tab)

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

Run both commands, in order.

claude plugin marketplace add vippsas/agent-toolkit
claude plugin install vipps-developer@agent-toolkit

Cursor

Open Settings, then Plugins.

Add vippsas/agent-toolkit as a plugin marketplace, then install the "vipps-developer" plugin.

Codex

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

Without installing

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.

The Access Token API exchanges your API keys for a short-lived token that you include in every subsequent request to confirm your identity.

Use your API keys to get the access token.

100%

API keys are exchanged for an access token, which must then be included in every API request.

Choose your authentication flow

Most merchants use standard authentication with sales unit API keys.

Merchants

Use your sales unit API keys with standard authentication:

• ✅ Main and supporting APIs
• ✅ Management API
• ✅ Report API

Partners

Use your sales unit API keys or partner keys with standard authentication:

• ✅ Main and supporting APIs
• ✅ Management API
• ✅ Donations API

Accounting partners

Accounting keys with specialized authentication give access to:

• Report API
• Sales API

Donations

Merchant-level keys with specialized authentication.

• Donations API
• Report API (for Donations reporting)
• Webhooks API (for Donations webhooks)

Donations partners can use their partner keys with standard authentication.

Go straight to a quick start guide

Each API's quick start guide covers authentication as part of the setup.

Technical details

• Standard authentication: Authenticate with sales unit API keys or partner keys.
• Specialized authentication: Authenticate with accounting or merchant-level keys.
• API reference: View the token endpoint specifications.