#
Service Endpoint Migration Guide
#
Introduction
The PageroOnline system now offers new OAuth2 endpoints that comply with the latest security standards, ensuring a more secure and reliable system integration..
Important
This guide is designed to assist our customers in seamlessly transitioning their current token endpoint and authorization endpoint integrations to the newly introduced endpoints. Additionally, the guide includes tailored approaches for different types of integrations, ensuring compatibility and ease of implementation for all use cases.
#
1. Migrating Token Endpoint
This section applies to all integrations that authenticate users through the Resource Owner Password Credentials Flow or refresh token pairs using the existing refresh token via the token endpoint.
- Token Endpoint (Legacy) : https://auth.pageroonline.com/oauth2/token
- Token Endpoint (New) : https://sso.pageroonline.com/oauth/v2/oauth-token
#
2. Migrating Authorization Endpoint
Warning
If you want to ensure a seamless migration without prompting users to log in again, the existing token pair must be refreshed to a new token pair via the legacy endpoint at least once before switching to the new endpoints. Refer to the Using a refresh token to obtain an access token section under Authorization Code Grant Flow for more details.
Important
Please check the new API structures and token information via the link here
This section applies to all integrations that authenticate users through the Authorization Code Grant Flow, obtaining an authorization code to exchange for a token via the token endpoint
- Authorization Endpoint (Legacy) : https://auth.pageroonline.com/oauth2/authorize
- Authorization Endpoint (New) : https://sso.pageroonline.com/oauth/v2/oauth-authorize