Integration and testing

This section covers everything you need to build and test your Vipps MobilePay integration: testing setup, integration options, payment operations, API guidelines, and best practices.

Testing setup

Get your test environment ready before building:

• Test environment – Access the Merchant Test (MT) environment, download test apps, and understand testing limitations and capabilities.
• API keys – Get your merchant API keys from the business portal for both test and production environments.
• Authentication – Learn how authentication works and which method applies to your integration.
• API servers – Find the correct server URLs for test and production environments across all APIs.

Integration options

Choose the right integration approach for your business:

• Point of Sale integrations – Learn about integrating payments in physical stores.
• Third-party integrations – Explore partner solutions and platforms.

Payment basics

Understand the fundamentals of how payments work:

• Payment overview – Get a comprehensive overview of payment flows and user experience.
• Payment rules – Learn about important payment rules and restrictions.
• Payment scenarios – Explore common payment use cases and implementations.
• Landing page – Understand the landing page experience for users.
• Webhooks – Set up event notifications for payment status updates.
• QR codes – Implement QR code-based payments.
• User data and privacy – Learn about handling user data responsibly.
• Terminology – Familiarize yourself with key terms and concepts.

Payment operations

Learn how to perform key payment operations:

• Initiate payment – Start a payment transaction.
• Reserve and capture – Understand two-step payment processing.
• Cancel – Cancel reserved or pending payments.
• Refund – Process customer refunds.
• Error handling – Handle errors and troubleshoot issues.

API guidelines

Follow best practices when working with our APIs:

• Polling guidelines – Learn how to poll our APIs efficiently.
• Timeouts – Understand timeout requirements and handling.
• HTTP headers – Use required and recommended HTTP headers.
• Order ID – Format and use order identifiers correctly.
• Transaction text – Provide clear transaction descriptions.
• URL validation – Ensure your callback URLs are properly formatted.

App handling

Optimize the user experience between your platform and the Vipps MobilePay app:

• App flow – Understand how users switch between your platform and the app.
• Redirects – Implement smooth redirect experiences.

Need help?

If you have questions or need assistance with payment implementation, visit our contact page or check the status pages for service updates.