> **Description:** How to set up credentials, access the test environment, and begin onboarding merchants as a Payment Service Provider using the PSP Merchant API.

# Setup

**MobilePay Online PSPs**

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](https://developer.vippsmobilepay.com/docs/APIs/psp-mp-api/README.md).

## 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](https://vippsmobilepay.com/en-NO/partner?tab_92e68=psp) 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. |

**Keep credentials secret**

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](https://developer.vippsmobilepay.com/docs/knowledge-base/top-integration-guide.md).

## 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](https://developer.vippsmobilepay.com/docs/knowledge-base/test-environment.md#test-apps) page.

**Read about the test environment**

Before you start testing, familiarize yourself with test environment limitations, restrictions, and best practices.

**[Test environment guide](https://developer.vippsmobilepay.com/docs/knowledge-base/test-environment.md)**

## Next steps

* [Quick start](https://developer.vippsmobilepay.com/docs/APIs/psp-merchant-api/psp-merchant-api-quick-start.md): Run the basic PSP Merchant API examples.
* [API guide](https://developer.vippsmobilepay.com/docs/APIs/psp-merchant-api/psp-merchant-api-guide.md): Learn how the PSP Merchant API works.
* [API reference](https://developer.vippsmobilepay.com/redocusaurus/psp-merchant-swagger-id.yaml): Browse the full API specifications.

> **Full site overview:** For every page in this documentation, read [https://developer.vippsmobilepay.com/llms.txt](https://developer.vippsmobilepay.com/llms.txt).
